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Preface 



Only recently has it been possible to manufacture a computer 
that is truly portable. Thus the microcomputer revolution has been 
launched, and society must learn to cope with this latest techno- 
logical rocket. Computer literacy is as necessary for survival as 
reading, writing, and aiithmetic. The literacy is obtained, like other 
skills, through exposure and practice. Learning to use the computer 
and learning to program the computer are two different activities. 
Using the computer with prepackaged programs that provide spe- 
cific functions is definitely an advantage, but to know how to pro- 
gram the computer to solve each unique problem is the level of skill 
I am addressing. 

Programming may be accomplished by using the various pro- 
gramming languages available for computers. Some of these lan- 
guages are transportable; that is, they are recognized by different 
machines with few changes, if any. BASIC, Pascal, FORTRAN, and 
COBOL are examples of such transportable languages. The skill I 
want the reader to acquire is more fundamental, for it involves pro- 
gramming in the instruction code of the processor. The instruction 
code is what interj)rets the higher level languages, such as BASIC, 
to a level that the processor can understand. In this case, a micro- 
processor will be studied because of its small size. In general, the 
instruction code is not transportable. 

What are the advantages of using instruction code? There are 
many, for instance, speed of execution and conservation of memory. 
But in my opinion, the most important advantage lies in the funda- 
mental understanding of how a computer operates, which is neces- 
sary in the use of instruction code. The concepts of programming and 
the skills acquired can be applied in all programming situations 
from the application of the transportable languages to the use of 
those esoteric codes defining the instruction set of a unique micro- 
processor. This understanding makes programming in any of the 
computer languages much easier, and the mystery of what is hap- 
pening inside those boxes that contain computers becomes clear. 
The relationship between hardware and software as an integrated 
system is made understandable. Equipped with that knowledge, 
you are better able to design dedicated systems to perform specific 
applications using the new technology for intelligent and flexible 
control. 



To learn this skill, it is necessary to have a development system. 
A development system is just that— its function is to help you de- 
velop systems. Generally, a particular microprocessor must be chosen 
for the controller to be used in the final design. It is helpful, but 
not necessary, to have this same microprocessor as part of the de- 
velopment system. If it is the same, a simulator to simulate the de- 
sired controller is not necessary. In this case, I have chosen the Z-80 
microprocessor manufactured by the Zilog Corporation. It is also 
available from several other manufacturers. The instruction codes 
of this microprocessor are also executable to a large extent, but not 
fully, on the 8085 and 8080 microprocessors manufactured by the 
Intel Corporation. The popularity of the Z-80 microprocessor makes 
it an ideal choice for a system controller. The development system 
is obtained by altering a Radio Shack TRS-80 Model I or Model III. 
We are fortunate in that the TRS-80 uses the Z-80 as its controlling 
microprocessor. The alteration to the TRS-80 can be accomplished 
by loading object code from a tape cassette or disk, or by removing 
the operating system in the read-only memory supplied with the 
BASIC machine, and replacing this memory with preprogrammed 
memory containing the object code that supports the FROLIC de- 
velopment system. 

A microprocessor does not make a development system, but a 
monitor to exercise the controlling microprocessor provides us with 
a tool to aid in writing software. Such a monitor is described in 
this book. Chapter 1 provides a detailed description of the hard- 
ware of both the Model I and Model III systems. Chapter 2 de- 
scribes the FROLIC monitor and the commands available to the 
user with this monitor. Some hardware is described that allows the 
inclusion of a single-stepping feature, an attractive additional com- 
mand to aid in system development. The ability to obtain written 
text or "hard copy" used to trace system development is provided 
in Chapter 3. Chapter 4 describes the hardware for programming 
erasable programmable read-only memory (EPROM) devices. This 
is a state-of-the-art programmer with features that are not normally 
found on the commercial equivalents at one hundred times the cost. 
The source code for driving the programmer for programming the 
most popular EPROMs is also given. In addition, the appendixes 
provide all the source code for the monitor. You are encouraged to 
use this code in any manner you deem appropriate. With a little 
study and acquired skill, it is hoped that you will alter the monitor 
to customize it for your own applications. 



John Paul Froehlich 
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CHAPTER 1 



fVlore Than BASIC 



One wonders about the number of applications for which the 
TRS-SO" system can be utilized. Two models are of particular con- 
cern. These are the Model I and Model III, as shown in Figs. 1-1 
and 1-2. As originally conceived by Radio Shack, the computer was 
constructed to execute programs using the BASIC language. BASIC, 
in the Radio Shack implementation, is an easy-to-use high-level lan- 
guage. (It is called high-level because while it is more easily under- 
stood by humans, it is not directly understandable by the computer. 
It must be translated into low-level instruction code, also known as 
machine code.) Each program line is scanned by an interpreter, 
translated, and then processed at program execution time. This 
method of execution wastes processor cycles and consumes a rela- 
tively large amount of memory. (This can be easily demonstrated 
by running BASIC programs that require a considerable amount of 
computation and comparing them with a similar machine code pro- 
gram. ) Many applications would benefit if they were programmed 
in the native instruction set of the processor, rather than in the 
higher level language that needs an interpreter. This would not only 
decrease the time of execution, but would reduce the memory re- 
quirement necessary to execute the same operation. The BASIC in- 
terpreter that consumes a considerable portion of memory would 
no longer be needed. Though machine code is more difficult to write 
than BASIC, the speed and memory factors make using the instruc- 
tion set worth the extra effort. 

A way to reduce the awkwardness of writing in hard-to-under- 
stand machine code (which is made up entirely of numbers) is to 

°TRS-80 is a registered trademark of the Tandy Corporation. 
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Fig. 1-1. TRS-80 Model I microcomputer system. 




Fig. 1-2. TRS-80 Model III microcomputer system. 

use assembly language. Assembly language assigns a very short 
mnemonic, or abbreviation, to every machine code instruction. This 
way, you can use the abbreviations instead of the numbers. An inter- 
preter for the assembly language, called an assembler, translates the 
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abbreviations into machine code. Most of the speed and memory of 
straight machine code is retained while writing difficulty decreases. 

Unfortunately, Radio Shack does not fully support the use of their 
system for machine code or assembly language programming. At the 
time of this writing, the programs that are available consist of T- 
BUG and an editor/ assembler (EDT/ASM) for the TRS-80 series 
which includes the Model I and Model III, Level I and Level II 
machines. 

T-BUG is a rather primitive monitor that allows the execution of 
machine code. This monitor is extremely sensitive to operator error, 
and after several hours one tires of its awkwardness. 

The extremely versatile editor/ assembler available from Radio 
Shack, which is used to write assembly language programs, is ham- 
pered because the execution of this program relies on the tape sys- 
tem. As a consequence, the editing and assembling process is quite 
slow, particularly for the Level I system because of its slower cas- 
sette data rate of 250 bits/second. The Level II system has the ad- 
vantage of increased cassette speed, which is extended to 500 bits/ 
second. Still, the use of this system for program development is far 
from desirable. Conditions improve considerably if one is fortunate 
enough to own an expansion interface that includes the disk oper- 
ating system. However, the editor/ assembler is not available from 
Radio Shack in a form that will operate with this system, but it is 
available from sources other than Radio Shack, thus allowing the 
use of the disk system in program development. It should be noted 
that Radio Shack does supply an improved monitor with the disk 
system (D-BUG). However, it has one major flaw: it does not exe- 
cute programs in real time. This makes it extremely difficult to de- 
bug critical time-delay loops. (This is explained later.) Monitors 
are available from other sources and many are quite good. It was 
with some of this software that the system presented was developed. 

The approach in this book is entirely different. The intent is to 
provide a complete turnkey development system that rivals those 
supplied by the major microprocessor manufacturers. (A turnkey 
system is one that is so complete that all the user needs to do is 
"turn the key" to begin operation. ) To have such a turnkey opera- 
tion it is necessary to alter the read-only memory in the TRS-80 
system. If such a "drastic" modification is not desired, then the user 
may load the software provided into a convenient set of locations 
and still have a powerful system. It seems that the only disadvan- 
tage of this approach is the additional overhead of loading the oper- 
ating system every time it will be used. If a user chooses to alter 
the read-only memory (a procedme described later in this chapter) 
he should be aware that before any repairs are made on the com- 
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puter, the original read-only memory (ROM) must be replaced in 
the keyboard unit before the equipment is returned tO a Radio Stiack 

service center. Radio Shack charges an additional fee for servicing 
if the seal on the keyboard unit has been broken. I have found the 
need for service on the keyboard unit to be rare. One can always 
use the software approach or use an external ROM technique. The 

advantage of placing the monitor in ROM is one of instant avail- 
ability as soon as the system is turned on; otherwise you must rely 
on the system-command loading procedures, an adequate compro- 
mise. If one is sure he has a reliable unit, the ROMs in the keyboard 
unit may be replaced with the development system ROMs, which 
now provide turnkey operation. 

The reader is free to determine the extent of modification to be 
performed on the TRS-80 system. In order to help you to create a 
development system from your TRS-80, the architecture of various 
models is described. 

As received, a Model I or Model III of the TRS-80 consists of a 
keyboard with electronics and a video monitor. In addition, the 
Model I includes a cassette-style tape recorder. The major differ- 
ence between these two models is that the Model III is a self- 
contained unit with provision made to add floppy disks internal to 
the system. The memory structure of both models is exactly the 
same with respect to memory allocations (memory-mapped video 
and keyboard, read/write memory, ROM, etc.); however, the units 
difEer in level structure by the amount of ROM actually installed 
in them. If the unit is a Level I system, the BASIC interpreter ROM 
occupies the lowest 4K of memory space, and the next 8K of mem- 
ory is uncommitted. In the Level II unit the BASIC interpreter ROM 
occupies the first 12K of memory space. The Model III TRS-80 uses, 
in addition, the next 2K of ROM starting at memoiy locations 3000H 
to 3800H (H = hexadecimal) for system utilities. With the exception 
of the tape storage and retrieval system, input and output operations 
are accomplished through memory locations. That is, the data from 
the keyboard is entered into the computer by reading memory loca- 
tions 3800H through 38FFH. Data generated by the processor is dis- 
played to the video screen by writing into locations 3C00H through 
3FFFH. In general, the second half of the fourth 4K block of mem- 
ory starting with 3800H through 3FFFH is used for mput and output. 
In addition, the Model I requires 32H locations immediately fol- 
lowing 3800H for communicating with the disk, real-time clock, cas- 
sette relay output latch, and the printer interface. Not all of these 
locations are used by the system, but the placement of the memory 
references effectively removes this space from being available for 
general-purpose use. 
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Memory space starting at 4000H and above is available for gen- 
eral memory purposes. The 4K machines have 4K dynamic read/ 
write (R/W) or random-access memory (RAM) devices occupying 
4000H to 4FFFH, and 16K machines have 16K dynamic read/ write 
devices occupying 4000H to 7FFFH. In both models the total mem- 
ory expansion capability is to 48K. The Model I microcomputer can 
readily be expanded from 4K to 16K by a slight internal alteration 
to the keyboard unit which involves changing the 4K R/W dynamic 
memories ( a set of 8 IC chips ) to 16K devices, and the reconfigura- 
tion of 2 DIP shunts. The DIP shunts can be replaced with dual in- 
line switches to allow for making these changes. Further expansion 
to the memory is possible with an expansion interface that can be 
your own design or the expansion unit available from Radio Shack. 
The expansion unit attaches to the TRS-80 using the 40-line edge- 
card connector. Memory expansion for the Model III unit is much 
simpler, since the memory expansion capability is part of the desk- 
top unit. 

To help clarify the memory structure of the two models, a mem- 
ory map of the TRS-80 system is shown in Table l-I. 

As stated earlier, the significant difference between the Level I 
and Level II systems is the 12K BASIC read-only memory (ROM). 
The 12K ROM supports an expansion interface and increased tape 
speed for program storage from 250 b/sec ( bits-per-second ) for the 
Level I machine to 500 b/sec for the Level II machine. In addition, 
the Model III can operate at tape speeds of 500 b/sec and 1500 b/ 
sec. If BASIC is "your language," then the ROM as supplied by 
Radio Shack should be considered because the disk BASIC does not 
use all of the utilities or subroutines provided in the ROM. A total 
commitment to the Radio Shack system must be considered if ex- 
tended BASIC programming is required. 

There is no intention to use BASIC in the development system 
that will be described here, so it will not be discussed further. 
Attention will be focused on the architecture of the system that is 
the same whether it is a Model I or a Model III system. 

Some of the differences and similarities between the various TRS- 
80 models have been described. More details of these models will be 
given later in this chapter. The important similarity that we wish to 
emphasize is that the computational "heart" of the two systems is 
identical. The computational device employed is a device called a 
microprocessor. This device is a complex design of thousands of tran- 
sistors and resistors in an economical, and physically small, package. 
The TRS-80 exploits the microprocessor's computational character- 
istics to the extent that the TRS-80 is, indeed, a microcomputer. 

Industrial pressures did not cause the development of the micro- 
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Table 1-1. Memory Maps of Model i and Model III 

TRS-SO Systems 



Hexadecimal 
Address 

OOOO-OFFF 


Model i 


Model III 


Level 1 


Level 11 


Level 1 


Level III 


4K BASIC 


12K BASIC 


4K BASIC 


12K BASIC 


1000-1 FFF 
2000-2FFF 


ROM 


ROM 


ROM 


ROM 






3000-3FFF 




4. 




I 


3000-37DF 








2K ROM for 


37E0-37FF 








System Utilities 
Memory-Mappe4 


Memory-Mapped 


Memory-Mapped 


Memory-Mapped 




37EB Printer 


37E0 Disk Select 
37E4 Relay 
37E8 Printer 
37EC CMD/Status 
37ED Track 
37EE Sector 


37E8 Printer 


37E8 Printer 


3800-3BFF 




37EF Data 






Keyboard 


Keyboard 


Keyboard 


Keyboard 


3C00-3FFF 


Matrix 


Matrix 


Matrix 


Matrix 


Video 


Video 


Video 


Video 


4000-4FFF 


Display | Display 


Display 


Display 


Start of Read/Write Memory 




4K Dynamic RAM Ends at 4FFFH 




5000-5FFF 


8K Dynamic RAM Ends at 5FFFH 




6000-7FFF 


16K Dynamic RAM Ends at 7FFFH 
End of Available RAM in Model 1 




8000-BFFF 


32K Dynamic RAM Ends at BFFFH 
Model 1 Requires Expansion Interface 




COOO-FFFF 


42K Dynamic RAM Ends at FFFFH 





processor to be used for the development of home computers. Indus- 
trial pressures were focused at producing a device that would sim- 
plify the development and/ or increase the intelligence of controllers 
while simultaneously reducing costs. The purpose of an intelligent 
controller is to reduce the complexity and cost of performing a spe- 
cific operation. In industry, the less complexity involved, the greater 
the reUability and the greater the ease of manufacture. 

To keep the cost of an intelligent controller low, most controllers 
do not include a full ASCII keyboard, a crt monitor, nor the BASIC 
language. Instead, a limited amount of external controls and indi- 
cators, if any, are usually involved. Instead of BASIC programming, 
only the machine language of the microprocessor is used. The use of 
the machine language of the microprocessor is more primitive in 
its structure when compared to BASIC. However, it is more flex- 
ible, faster, can be made to operate in real-time, and uses far less 
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memory for a programmed function. (Remember that the Level I 
uses 4K of memory and the Level II uses 12K of memory alone to 
hold the BASIC interpreter and the system utilities. ) 

Some examples of intelligent controllers using microprocessors are 
foimd in heating controllers, automated test equipment, automotive 
products, sewing machines, microwave ovens, and the tremendous 
variety of hand-held electronic games presently appearing on the 
consumer market. When industry decides to build any of these de- 
vices, a development system is usually employed. A development 
system allows the designer to develop and test the software used 
to control a microprocessor, to emulate the microprocessor, and to 
examine the execution of the control function in process. Typically 
a development system runs into thousands of dollars. There is, how- 
ever, an inexpensive solution. 

The solution is to modify a TRS-80 for the following reasons. 
First and foremost is that the microprocessor used in the TRS-80 
system is a Z-80, designed and manufactured by the Zilog Corpora- 
tion and second-sourced by the Mostek Corporation. Many of the 
Z-80 microprocessor instructions are directly compatible with the 
Intel 8080 and 8085 microprocessors, second-sourced by many com- 
panies. These three devices are used extensively by industry in con- 
trol applications. It is true that both the 8080 and 8085 have fewer 
instructions, and there are hardware differences between the Z-80 
and the Intel devices. However, there are more similarities than dif- 
ferences, and the ease of making adjustments encourages the use of 
the development system to be described, whichever processor is 
chosen. The software and optional hardware features which are 
presented in this book allow the system to have all the capabilities 
of a comprehensive development system. For turnkey operation this 
involves the purchase of erasable programmable read-only memory 
(EPROM) at an additional cost of about $20. (A preprogrammed 
version of this EPROM is available. The address of the supplier is 
given in Appendix C. ) The last consideration is the availability of 
the data, address, and control lines at the edge-card connector of the 
keyboard unit. It is also possible to implement the TRS-80 unit in 
the actual control application and utilize its internal Z-80 as the 
controlling microprocessor. If this is done, the crt and keyboard are 
available for the small investment in the Radio Shack TRS-80 com- 
puter which includes 4K RAM and either 4K, 8K, 12K, or 14K ROM 
capabilities. 

To take advantage of the TRS-80 as a development system, one 
should be familiar with the Z-80 processor. The best source for this 
information is one of the manufacturer's technical reference man- 
uals for this device. (See Appendix B.) The link of the Z-80 micro- 
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processor to the external world with the TRS-80 is either the 40-line 
( Model I ) or the 50-line ( Model III ) edge-card connector. The sig- 
nals present on these edge-card connectors are listed in Tables 1-2 
and 1-3. The use of these connectors is one of the most significant 
differences between the Model I and Model III TRS-80 Radio Shack 
systems. Historically, the Model I system was first available. There- 
fore, the Model I system is first covered in the "in-depth" discussion 
which follows. The edge-card connector is presented first, and then 
the details of the port assignments, video access, graphic capabilities, 
keyboard input, and information storage and retrieval are presented. 
The Model III description follows; it concentrates on the significant 
differences between the two models. 

MODEL I TRS-80 

Shown in Table 1-2 are the signals present at the 40-line edge- 
card connector. Most of the lines are buffered, and it may be desir- 
able to buffer those remaining lines if you are going to interface 
to this connector. Let's examine each of the terminations at this edge 
connection. 

The terminations from the processor board fall into the following 
categories: 

1. Data 

2. Address 

3. System Control 

4. Interrupt 

Data 

The first terminations to be considered are the data lines. These 
eight lines are bidirectional, and therefore data is available from the 
processor or made available to it. These lines are buffered using 
74LS367 (DM8097) TTL circuits, which are hex three-state nonin- 
verting buffers. As the buffers are three-state, the TEST line controls 
the three-state function while the microprocessor determines the di- 
rection of the data flow. Even though the TEST line has control over 
the data buffers, this is not its only function. 

Address 

There are 16 address lines which are all output lines. This gives 
the processor the capability of addressing 65,536 locations. The same 
type of buffer is used on these lines, and the activation is controlled 
by the TEST signal. 
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Table 1-2. Edge-Card Connections for Interface Signals 
Available From the TRS-80 Model I System 





Signal 






Pin 


Name 


Description 




1 


RAS/ 


Row Address Strobe Output for 16-Pin Dynamic 


RAMs 


2 


SYSRES/ 


System Reset Output, Low During Power Up Initialize or | 






Reset Depressed 




3 


CAS/ 


Column Address Strobe Output for 16-Pin Dynamic 


RAMs 


4 


AlO 


Address Output 




5 


A12 


Address Output 




6 


A13 


Address Output 




7 


A15 


Address Output 




8 


GND 


Signal Ground 




9 


All 


Address Output 




10 


A14 


Address Output 




11 


A8 


Address Output 




12 


OUT/ 


Peripineral Write Strobe Output 




13 


WR/ 


Memory Write Strobe Output 




14 


INTAK/ 


Interrupt Acknowledge Output 




15 


RD/ 


Memory Read Strobe Output 




16 


MUX 


Multiplexer Control Output for 16-Pin Dynamic 


RAMs 


17 


A9 


Address Output 




18 


D4 


Bidirectional Data Bus 




19 


IN/ 


Peripheral Read Strobe Output 




20 


D7 


Bidirectional Data Bus 




21 


INT/ 


Interrupt Input (Maskable) 




22 


Dl 


Bidirectional Data Bus 




23 


TEST/ 


A Logic on TEST/ Input Three-States A0-A15, 
WR/, RD/, IN/, OUT/, RAS/, CAS/, MUX/ 


D0-D7, 


24 


D6 


Bidirectional Data Bus 




25 


AO 


Address Output 




26 


D3 


Bidirectional Data Bus 




27 


Al 


Address Output 




28 


D5 


Bidirectional Data Bus 




29 


GND 


Signal Ground 




30 


DO 


Bidirectional Data Bus 




31 


A4 


Address Bus 




32 


D2 


Bidirectional Data Bus 




33 


WAIT/ 


Processor Wait Input, to Allow for Slow Memory 




34 


A3 


Address Output 




35 


A5 


Address Output 




36 


A7 


Address Output 




37 


GND 


Signal Ground 




38 


A6 


Address Output 




39 


GND 


Signal Ground 




40 


A2 

ri n n n f 


Address Output 

g n 13 15 W !9 1} ?3 25 2J 29 31 33 35 3? 39 

nnnnrn'^r-'nnnnnnnnn 






uu UUl 


juljuuuuuuuuuuuuli 




; 4 6 B 


!G 13 u 16 16 30 33 2< 3S 38 30 33 34 35 33 40 
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System Control 

The next four signals control the direction of data flow to /from 
the processor at the correct time in the processor cycles. They are 
obtained from the CPU control system signals originating from the 
Z-80 microprocessor. These signals, as defined by the Zilog Cor- 
poration, are memory request (MREQ/), input/output request 
(lORQ/), read (RD/), and write (WR/). These are not the sig- 
nals at the 40-pin edge connector, but are signals generated by the 
Z-80 chip. (The '/' is used to indicate active-low, logic zero asser- 
tion of these signals. ) Proper gatins; of these lines gives us the four 
TRS-80 bus control signals: read (RD/ ), write (WR/ ), input (IN/ ), 
and output ( OUT/ ) . These signals are active, or asserted, in the low 
state, thus the "slash" (a convention used throughout this book to 
indicate an active low condition). The RD/ and WR/ are used for 
memory reference instructions; the IN/ and OUT/ are used for pe- 
ripheral control to port locations. These signals make interfacing to 
the computer bus a minimal effort. 

interrupt' 

The next lines considered are the interrupt ( INT/ ) and interrapt 
acknowledge (INTAK/). As dehvered, the TRS-80 system allows 
using only one of the three interrupt modes that the Z-80 micro- 
processor supports. The expansion interface that supports the disk 
operating system contains a real-time clock that provides a 25-ms 
interrapt to the INT/ line for some real-time applications. The TRS- 
80 system uses this signal to support a 24-hour clock. It is important 
to realize that if the expansion interface is connected and the inter- 
rupt is enabled through a software command, a system "crash" will 
result if software to support the requested interrupt is not present 
in memoiy. Radio Shack has provided the software on the Level II 
system to support the clock. However, once you modify the system 
with the new software ( a software modification here, not hardware ) 
a potential loss of control is possible. The single-step feature in the 
FROLIC monitor uses the interrupt to end execution of a single in- 
struction. The expansion interface 25-ms clock must be altered to 
prohibit interrupts if the single-step option is desired. 

Having the full interrupt features of the Z-80 microprocessor is 
not necessary for successful use of the FROLIC monitor. However, 
in some applications, the availability of the full interrupt features 
may be useful. 

Two interrapt modes that the Z-80 uses cause a vector to the ad- 
dress 0038H. These are the mode and mode 1 interrupts. At power- 
up and reset, mode is automatically enabled. Even though the 
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mode is established, the microprocessor will not respond to inter- 
rupts unless the interrupt enable instruction ( EI ) is executed using 
the proper software command. With mode 0, it is necessary to strobe 
an FFH onto the TRS-80 data bus using the INTAK/ to cause a 
vector to 0038H. Up to eight restart vectors may be strobed on the 
data lines. In fact, the instruction does not need to be one of the re- 
start instructions (RST), but any valid insti-uction in the Z-80 in- 
struction set may be used. Further details can be obtained from the 
Z-80 technical manual. However, by changing the mode of interrupt 
from to 1 using the appropriate instruction ( IM 1 ) , it is not nec- 
essary to strobe an instruction on the data lines. The processor auto- 
matically vectors to address 0038H. The TRS-80 only supports the 
Z-80 mode 1 inteiTupt, and the Z-80 only vectors to the RST 38H 
address. 

The strobing of instructions or address data into the proces- 
sor from a peripheral is one of the functions of the INTAK/ line. 
Its function is identical to that of the RD/, except that the source of 
the data is not from a memory reference. If mode is used, you 
should not expect an FFH to be strobed on the data lines by default 
without supplying the necessary hardware using the INTAK/ to 
guarantee its presence. 

The third mode of intermpt (mode 2) is a vector type, but in 
this case the lower 8 bits of the addi-ess of a pointer where the ac- 
tual interrupt program resides are strobed on the data lines using 
tlie INTAK/ signal. The high-order address of the pointer is ob- 
tained from data present in a special register (I register) in the 
microprocessor. Instructions to load the high-order vector in the I 
register and to indicate a mode 2 interrupt must be executed before 
any interrupt using this mode is executed. 

Another function of the INTAK/ line is to indicate to the periph- 
erals that an interrupt has occurred. This line was provided in the 
TRS-80 design so that interrupt flags can be cleared without soft- 
ware overhead. As we see, it can also be used if the TRS-80 is modi- 
fied for mode or mode 2 interrupts to perform the strobing of data 
as just described. 

To take advantage of the first and third modes of interrupt on 
a Model I TRS-80 system, a slight modification must be implemented 
within the keyboard unit. It involves the alteration of the TEST/ 
line input circuitry. Later in this chapter a list of the modifica- 
tions that can be made to the Radio Shack Model I and Model 
III systems will be given. To use these modes after the hardware 
modifications have been made, it is necessary to provide the soft- 
ware support that will alter the mode and load the interrupt vec- 
tor if required. 
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Additional Control Signals 

The WAIT/ line is used to "inject" wait states into the program 
flow in order to accommodate slow devices. This will not be used, 
nor considered further. Caution: Holding the wait state line low for 
a period longer than 0.5 ms will disrupt the normal operation of the 
dynamic random-access memories. 

The SYSRES/ line is used to reset the system. Because of the use 
of dynamic memory, it was necessary to use the nonmaskable inter- 
rupt input for system reset. This will point the microprocessor to a 
known address when the reset push button to the left of the edge- 
card connector is depressed. This reset is useful when a system 
"crash" occurs. The use of nonmaskable interrupt instead of the 
RESET pin of the microprocessor allows for the refreshing of dy- 
namic memories without data losses. 

The TEST/ line isolates the Z-80 from the external devices. It 
places all data and address lines, the RD/, WR/, IN/, OUT/, RAS/, 
CAS/, and MUX/ signals in the high impedance "third" state. The 
TEST/ line may be modified in the development system, but it is 
easily restored if servicing is required. 

The row-address strobe (RAS/), column-address strobe (CAS/), 
and multiplex control line ( MUX/ ) are used to expand memory us- 
ing dynamic random-access memories (RAM). It is quite easy to 
interface the system to dynamic RAM because of the presence of 
these signals. 

Absent Control Signals 

One of the signals absent on the edge connector is halt acknowl- 
edge (HALT/). It is impossible to use the assembly-language 
HALT instruction in an unmodified TRS-80 system, for the designer 
of the Radio Shack system has taken the HALT signal and ORed it 
with the RESET signal, and the output of this gate goes to the non- 
maskable interrupt pin of the microprocessor. This results in re- 
setting the system if a HALT rastruction is executed by the micro- 
processor. 

Another signal absent from the edge-card connector is the Hne 
which indicates that the machine is in a fetch state of the machine 
cycle (Ml/). This line is useful for single-step hardware modifica- 
tion, but not essential. A reference to this line occurs at the end 
of Chapter 2. If the use of this line is desired, an additional modifi- 
cation is required and is given in the section dealing with the single- 
step implementation. 

A ground is provided in several locations. In older units, +5 V dc 
is accessible at pin 39; however, a modification by Radio Shack re- 
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moves this power connection in newer models. In any event, you 
should not attempt to use the TRS-80 +5 V for any external circuits. 
An external power supply should be used for such external circuits, 
along with a common ground connection to the TRS-80. 

This completes the discussion of the signals available at the edge- 
card connector. It is helpful to discuss features that involve hard- 
ware peculiar to the TRS-80. These include port assignment and 
functions, video, graphic capabilities, keyboard, information stor- 
age and retrieval by tape, and lower-case conversion possibilities. 
Some schematics are presented, but these illustrations are not de- 
tailed. In many cases, the schematics are modified in order to aid 
understanding. Functional purpose is the primary concern. This is 
necessary if one wishes to understand the instructions contained 
within the monitor as listed in the Appendixes. If this is of no con- 
cern, skim this section and go to the modification description. 

Port Assignments 

Only one port is assigned in the Model I TRS-80 system, and 
that port is FFH, which is used for both input and output. As an 
output port, the TRS-80 uses bits and 1 of the port bus to produce 
a square wave of 0.85 volt peak amplitude. This signal is applied 
to the input of a cassette recorder by way of the 5-pin DIN con- 
nector. Actually, any audio recorder may function as a recording 
device. The logic on bits and I of port FFH detei-mines the volt- 
age level. A 0.46-volt level is established by outputting zeros on 
these two lower-order bits (bit = and bit 1 = 0). When the two 
bits equal 01 ( base 2 ) , a 0.85-volt level is produced. When the two 
bits equal 10 (base 2), a 0.00- volt level is produced. The 11 (base 
2) condition is not used. Bit 2 of port FFH is used to control the 
motor of the recorder, and when high it activates a reed relay switch, 
turning on the recorder. Bit 3 is the last bit of this port to be used 
by the TRS-80 system. This bit allows control of the large graphic 
or alphanumeric presentation to the video screen. Normally 1024 
locations are used for the display of data written to the screen R/W 
memory located from 3C00H to 3FFFH. In the enhanced display, 
only the even memory locations are used, and the data characters 
residing in these locations are extended horizontally and occupy 
two positions on the video screen. Therefore, only 512 locations are 
visible, and 16 lines of display data are possible. 

As an input, port FFH uses only two bits. Bit 7 is used for read- 
ing the cassette. Bit 6 contains the information for enhanced dis- 
play mode. If enhanced horizontal presentation is currently acti- 
vated, then this bit is 1. Otherwise, it is 0, indicating normal screen 
presentation. 
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Video Output 

Information can be "viewed" by the user by writing to memory 
locations 3C00H to 3FFFH. The data located at these addresses is 
shared by the crt and the microprocessor. Through the use of spe- 
cial decoding ROMs, this data is converted to familiar characters 
and is displayed on the monitor screen. The characters shovm are 
those defined by the American Standard Code for Information Inter- 
change (ASCII). Without modifications, only upper-case charac- 
ters, numerals, and punctuation marks are available. In addition 
there is a set of graphic "characters." The pattern of a graphic "char- 
acter" is determined from the byte written to the shared video R/W 
memory. If the most significant bit (7) is active or high, the result- 
ing display is graphic; otherwise, the display is alphanumeric. The 
six lower bits of the byte written to the screen R/W memory lo- 
cated from 3C00H to 3FFFH determine the pattern on the video 
screen. This memory space results in 16 lines, each having 64 char- 
acter or graphic positions. If bit 7 is a logic 1, the remaining six bits 
can generate one of 64 possible graphic characters within each of 
the 1024 graphic block positions. As the TR-80 Model I is deliv- 
ered, there are only 7-bit words available for storage in the video 
RAM. The "missing" bit (6) is not used. Therefore, the patterns and 
characters formed on the display are "repeated" and thus are not 
dependent on the absent bit. Fig. 1-3 shows how the six bits deter- 
mine the screen pattern. With the aid of the monitor, you can write 
graphic words to the video addresses. This is a good method of 
seeing the graphic capabilities of the TRS-80. 

Radio Shack provides a lower-case modification for the Model I 
that adds the "missing" memory bit and expands the video word 
to a full byte. Also included in this modification is a replacement 
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Fig. 1-3. Graphic patterns formed with the six least significant bits. 
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for the video character-generating ROM, which provides for dovi?n- 
ward extension, thus allowing characters such as y and g to extend 
below the hne. You can add your own modification by providing the 
additional memory and a switch to activate it, thereby obtaining 
the full display features available in the ROM. However, one must 
replace the ROM character generator with the updated version to 
obtain the automatic extension feature. It is suggested that if lower- 
case is required, you purchase the LC modification kit from Radio 
Shack. The feature may be nice but it is not essential to the devel- 
opment system. 

Keyboard Input 

The keyboard is a matrix device, and the layout of the keys in 
relationship to the data and address lines is shown in Fig. 1-4. Some 
logic has been oiinitted from the schematic so as not to clutter the 
presentation. The most important feature of this arrangement is the 
many possibilities for decoding. In fact, one page (256 bytes) of 
memory is lost to this area, but this results in many unique codes 
(upwards of 200). The addressable memory space that is used to 
detect a response on the data lines starts with address 3801H and 
continues to 38FFH. To obtain a unique code, the programmer must 
be careful. For example, the addressing of memory 38FFH results 
in the possibility of any key producing a response, since all eight 
address lines will be active, whereas addressing 3808H will only 
produce a response if the X, Y, or Z key is depressed. The matrix 
of the keyboard is such that a unique line is accessed by the fol- 
lowing address excitations: 3801H, 3802H, 3804H, 3808H, 3810H, 
3820H, 3840H, and 3880H. Since location 3880H has only one key 
attached, the SHIFT key, accessing this location may be used for 
quick unique exits from a software loop. An example of the short 
assembly-language code required to detect this key closure is shown: 



EXIT LD A, (3880H) 
OR A 
RET Z 



READ DATA AT LOCATION 3880H 
SET ZERO FLAG AND 
RETURN TO LOOP IF NONZERO 
START OF ESCAPE 



If one vdshes to see if any key is pressed, replacing 3880H with 
38FFH accomplishes this. 

It is obvious from the schematic which keys will produce data on 
the data lines (when pressed) if their particular line is accessed. 
It is the function of the key-scan rout&e to eliminate 'Tjounce." 
(Mechanical switches take time to settle, and the processor speed 
in executing code is such that contact bounce, or repeated open- 
ing and closing, results in producing multiple readings of the key 
unless corrective action is taken. ) Another function of the scanning 
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■Model I: Right shilt. lelt stiill on data line 0. 
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Fig. 1-4. Keyboard matrix for Model I and Model III microcompul'er systems. 

routine is to produce a code to represent the key. The American 
Standard Code for Information Interchange (ASCII) format is the 
usually accepted form. 

Tape Input/Outpyt 

A few words on the tape format as established by Radio Shack 
for the Level II systems follow. The rationale for this format is 
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sound, but problems in saving data do arise due to head alignment 
and improper recording and playback levels. Careful attention must 
be paid to these levels. 

Information saving and retrieval in the TRS-80 system uses mag- 
netic recording media with a standard audio cassette as the storage 
element. Certified computer tape improves the reliability, but ex- 
change of information between systems sometimes pres'ents a prob- 
lem. It is also useful to bulk-erase a cassette before it is reused to 
store new information. 

Data is recorded at the rate of 500 b/sec. This rate corresponds 
to approximately 62 bytes per second. To maintain compatibility 
with existing object code tapes produced by Radio Shack and other 
sources, this format is used for cassette storage in the FROLIC moni- 
tor program. 

Data is stored on the tape by a series of pulses. The pulses are 
spaced every 2 ms, which establishes the frame for written data. 
As you probably know, the data is in serial form, one bit after the 
other, and consists of representations for logic 1 and logic 0. To re- 
cord a logic 1. an additional pulse is recorded within the 2-ms time 
period. A center position of 1 ms is chosen. The absence of a pulse 
indicates a logic 0, and, consequently, both logic conditions may now 
be represented. The pulses are generated for recording using the two 
least significant bits of a data byte written to port FFH. The refer- 
ence level is established from the output of 00 in these b't positions. 
This produces a dc level of 0.46 volt. A pulse is formed by the out- 
put of thi-ee consecutive bit patterns that change the reference level 
first to 0.85 volt, then to volt, with a final return to the 0.46-volt 
reference. The upper and lower voltages are each held for approxi- 
mately 0.1 ms. Therefore, the pulse is fonned by output of a 01, a 
short delay, output of a 10, another short delay, and finally an out- 
put of 00. (In this illustration, only bits and 1 of the port output 
ai'e given. ) All of these data patterns are written to port FFH with 
bit 2 active to maintain the recorder in a ranning state. Fig. 1-5 
shows the levels associated with the output patterns in relation to 
the pulses and pulse separation for the transmission of both a logic 
and a logic 1. 

Tape Data Format 

In order that this technique of recording data to cassette tape 
be successful, it is necessary to synchronize the data and establish 
a format so that the receiving device can process the data in an 
acceptable manner. In addition, an error-detection byte is added 
to provide simple indication of a valid transfer from tape to CPU. 
The following scheme is used for writing data on the cassette re- 
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Fig. 1-5. Data pulses for cassette output. 

corder. First, the recorder is turned on with the 0.46-volt level es- 
tablished. An output of 40H to port FFH starts the write routine. 
A time delay is necessary to allow the recorder to reach constant 
speed. One second is sufficient, but generally a longer delay exists 
on tapes. Logic Is and Os are written on the tape, but in order to 
establish data presence, a synchronization byte is required. The in- 
dication that data is about to be available is flagged by the decoding 
of an ASH, which is the tape synchronization mark. From this time 
on, synchronization must be maintained, or an unsuccessful write 
will be the result. Immediately following the ASH synchronization 
mark is the label mark 55H. The next six bytes of data are used for 
tape identification. Data must be present to fill these six locations, 
or synchronization is lost during the read command. After the iden- 
tification, the next byte must be either a 3CH or a 78H. The 3CH 
indicates a data block follows. A 78H indicates the execute address 
of the loaded program to the reading routine. 

The data blocks are formatted in the following manner. The first 
byte following the 3CH indicates the number of data bytes in the 
block. A OOH means 256 data bytes. This is the maximum for a block 
length. The minimum block length is indicated by a OIH, which 
states that only one data byte is present in the block. The next two 
bytes written to the tape are the low and high addresses which es- 
tablish the starting location of that data block. The reading routine 
uses this data to indicate the starting address in memory for deposit. 
Error detection is provided using a checksum. The checksum is 
formed by the addition of each byte written to the tape starting 
with the value of the address. Only one byte is used for the com- 
puted checksum. Therefore, all carries are ignored. This sum is 
stored in memory and updated as the writing of the block continues. 
Upon completion of a block, the checksum is output as the last data 
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in the block. It is not included in the checksum computation, but 
it is compared against the computed checksum. If the two check- 
sums are equal, then data transfer occurred without error (it is as- 
sumed ) . If more data is to be written, the block mark 3CH is used 
to signal that more data follows. 

The last information written on the tape is used to indicate the 
execute address of the program just written. A 78H is the signal to 
the reading program that the next two bytes on the tape form the 
address of execution. Like most addresses, the low byte precedes 
the high byte. No checksum is used in this block. The last three 
bytes complete transcription of the tape. 

The method used for reading a tape produced in the TRS-80 
format just described will require a conditioning circuit to convert 
the pulses on the tape to logic levels suitable for decoding. The pulse 
described has a fundamental period of 0.2 ms. As a result, there is 
a strong fundamental at 5000 Hz. This frequency is suited for the 
audio cassette with the higher harmonics filtered by the electronics 
in the recorder. The presence of a pulse on the cassette tape causes 
a data latch consisting of a set-reset logic flip-flop to be set. If one 
viewed the output of the cassette on an oscilloscope it would reveal 
a few cycles forming a tone burst with a fundamental of 5000 Hz. 
The tone bursts are amplified and rectified. As a result of this pro- 
cess, a negative asserted pulse latches the flip-flop. Any new pulses 
processed by the electronics will have no effect on the latch unless 
this latch is cleared. The clearing of the data latch is accomplished 
using a hardware-software technique. The technique generates the 
necessary signals that clear the latch. If you study the monitor list- 
ing in Appendixes D and E under the section dealing with the cas- 
sette-read section, you will notice the instruction OUT (OFFH),A. 
Any data may be output at this time. However, for the Model I sys- 
tem, the cassette unit must remain on. This requires the presence 
of a logic 1 in position bit 2 of the port FFH latch. Since the elec- 
tronics used for recording are not active during the reading process, 
the states of the data in bits and 1 are of no consequence. The 
graphic mode used to control the width of characters written to the 
crt RAM is controlled by bit 3. This also does not affect the tape 
function. Therefore, the only bit of consequence in clearing the 
latch is bit 2, which must remain active 

If upon clearing the latch with an OUT ( OFFH ) ,A, a read using 
IN A, (OFFH) results in the presence of a logic 1 in bit 7, then a 
pulse passed the read tape head. If logic is in bit 7, then no pulse 
is present. 

The software required to read a data track first looks for pulses 
or single bits. A "leader" is always written that consists of up to 
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256 pulses spaced 2 ms apart. The minimum number of pulses re- 
quired is that which ensures that the cassette has reached its opera- 
tional speed. To read a TRS-80 tape you must first obtain synchro- 
nization. This is accomplished by reading data pulses and storing 
these pulses by shifting them sequentially into a register. Testing 
this register for the sync mark ASH after each shift will at some time 
produce the required synchronization. Once this is established, the 
data then can be read a byte at a time. The sequence used in the 
software to read the tape will first search for the identification mark 
55H. This mark must be the byte following the sync mark. Follow- 
ing the identification mark are 6 bytes used for a tape label. The 
data mark 3CH is the next byte in the sequence. It is followed with 
the byte used to indicate the number of data bytes in the current 
block. The low address followed by the high address informs the 
software of the address of the first location at which data is to be 
stored in memory. 

The data bytes are next in sequence. The last byte in the block 
is the checksum. The calculation of checksum byte started with the 
loading address and ended with the last data value in the block. 
The tape reading finishes when the software detects the execute 
address mark 78H in place of 3CH. The execute address follows in 
two bytes, but there is no checksum computed for this address. 

TRS-80 MODEL ill 

Only the changes in the hardware of the Model III which di- 
rectly affect the operation of the FROLIC monitor are given in 
this section. The two models are configured with identical memory 
mapping, and this contributes to the compatibility between the sys- 
tems. The differences occur in five areas. The first section covers 
the Model III bus; the second, the port assignments; the third, the 
video display; the fourth, the keyboard; and the fifth, information 
storage and retrieval. 

The interface of the TRS-80 Model III to the external world con- 
sists of a 50-pin edge-card connector. There is no relationship be- 
tween this connector and the 40-line edge-card connector used for 
the Model I. Only those signals for port select and control or reset 
are included on this edge-card connector. These include address 
lines, data lines, and control lines. To allow data flow at the edge- 
card connector, the edge-card connector is made active by an out- 
put of lOH to port ECH. This is one of the new ports that is avail- 
able on the Model III system. Table 1-3 shows the signals available 
at this edge-card connection. Every signal has a ground associated 
with the line. Disabling the 50-line connector so that no signals are 
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Table 1-3. Interface Signals Available From the TRS-80 

Model ill 



Pin Number 


Function for TRS-80 or Z-80 
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DataO 


3 


Data 1 
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Data 2 
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Data 3 
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Data 4 


11 


Data 5 


13 


Data 6 
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Data 7 
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Address 


19 


Address 1 


21 


Address 2 


23 


Address 3 


25 


Address 4 


27 


Address 5 


29 


Address 6 
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Address 7 
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IN/ 


35 


OUT/ 


37 


RESET/ 
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INT/ 
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I/O WAIT/ 


43 


DATA BUS IN/ 


45 


(Not Used) 


47 


Ml/ 
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lOREQ/ 


2-50 (Even) 


Ground 
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present on the bus may be accomplished by an output of a in the 
fourth bit of port EOH. 

Port Assignments 

The following ports are used in the Model III: EOH, E4H, E8H, 
E9H, EAH, EBH, ECH, FOH, FIH, F2H, F3H, F4H, and FFH. 
(Ports EOH and ECH are not uniquely decoded. That is, EIH, E2H, 
and E3H may be used to address port EOH; and EDH, EEH, and 
EFH may be used to address port ECH.) Not all the functions of 
these ports are known at this writing, but those relevant to the 
FROLIC monitor are described. Ports FFH, EOH, and ECH are 
important to the FROLIC monitor. 

Port FFH functions as both input and output. As an output port. 
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the least significant bits (0 and 1) are used for level control in the 
recording process as they were in the Model I system. The function 
of the other bits of this port is not known. As an input port, it ap- 
pears the function of the least significant bit (0) is pulse detection 
and timing from the cassette recorder input conditioner. Bit 1 is 
used as a flag to signal that the cassette motor is operating. Bit 2 
is used to indicate that the extended graphic mode is active. ( The 
Model I system used bit 6 as this flag. ) Bit 3 shows that the alter- 
nate character set is active. Bit 4 is used to show that the external 
i/o data and control lines are active. Bit 5 is unknown. Bit 6 is al- 
ways active, but its function is also unknown. Bit 7 is from the data 
latch. It is set by data pulses from the output of the cassette. It is 
reset by an input to port FFH, and its function is identical to that 
in the Model I system. However, the function of bit of Port FFH 
is different than that of bit 7, in that it is active during data transi- 
tions, and not latched as is bit 7. The data latch, you recall, stores 
flux transitions that pass the read head of the cassette player. These 
transitions are either the data or separation pulses. However, bit 
is active only when a pulse is detected. There is retention in a latch 
unless another transition is detected, at which time the flag is com- 
plemented. After a long delay with no flux transitions, the flag is 
automatically cleared. 

Port ECH (EDH, EEH, and EFH) controls some of the periph- 
eral fimctions of the TRS-80 Model III. The operating state of these 
peripherals is made known by the input status of port FFH. To acti- 
vate these functions, outputs to port ECH are made. The cassette re- 
corder motor, the mode that controls the horizontal width of the 
crt display, the selection of character sets, and 50-line bus activa- 
tion are all controlled by this port. To turn on the cassette, a 02H 
is written to port ECH. Likewise, an output of 04H alters the hori- 
zonal size, a 08H selects the alternate character set, and a lOH 
enables the control-data lines for external i/o. An output of 20H 
alters the status flag of port FFH, but the function of this flag is 
unknown at this time. The activation of the remaining three bits, 0, 
6, and 7, produces no visible effect. 

Port EOH is used as a priority interrupt control and status port. 
The highest priority device is connected to bit 0, and the lowest is 
connected to bit 7. A logic (active low) indicates a device has 
requested an interrupt. The status of those devices requesting to 
interrupt is determined by an input of port EOH. To allow a de- 
vice to interrupt, port EOH must enable a gate to allow the inter- 
rupt to reach the status latch. In addition, the instruction EI (en- 
able interrupt ) must have been executed. For an example, an OUT 
EOH OIH or 02H allows the data pulse from the cassette tape to 
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produce an interrupt. Depending upon which data was output, 
the pulse produces the highest or second highest priority. The 
Model III uses this for tape read operations. An OUT EOH 04H sets 
bit 3. This allows the real-time clock pulse to interrupt the proces- 
sor. OUT EOH 08H allows the interrupt from the external bus to 
reach the processor. The source of other intermpts is not known, 
but locations in R/W memory make it possible to direct control to 
any place in memory. The locations for transfer in the unmodified 
TRS-80 Level II are at 403DH, 4206H, 4209H, 4040H, and 4043H. 
The addresses are listed in interrupt priority and are levels 3, 4, 5, 
6, and 7. In a system of your design, your software should interro- 
gate port EOH, and control transfer should be specified by your 
program. 

Ports E8H, E9H, EAH, and EBH are used for the RS-232C com- 
munication link. These function in identical manner to the functions 
of the RS-232C used in the Model I. An interface is required to take 
advantage of these ports. 

Ports FO, Fl, F2, F3H, F4H, and E4H are used for the floppy disk 
controller. A Western Digital FD1791 is used in this application. 
Port F4H controls the drive select with the least significant bits used 
for drive selection. It appears bit 7 of this port controls the density 
mode, with a logic 1 indicating double density. Bit 6 controls the 
gating of the data request Hue (DQR) to the wait pin of the Z-80 
processor. This allows the processor to go into a wait state until the 
byte of data from the disk controller is available. This does not dis- 
turb the memory refresh cycle. When the processor examines the 
software control for disk boot-up, an output is made to port F4H 
of value CIH. Port FOH is used for command words and status. 
Port FIH is used for track data, and F2H is used for sector data. 
Port F3H is used for the data. Port E4 is also used in disk opera- 
tions. The most significant bit is used. It is assumed that this allows 
the interrupt of the controller to interrupt the Z-80 microprocessor 
when it has finished the current command from the disk controller. 

Video Output 

The changes to the video section are also significant. Both upper- 
case and lower-case characters are available. (The FROLIC moni- 
tor uses only the upper-case values and masks out the new charac- 
ters. However, by changing the mask, the user has access to the 
lower-case letters.) Through the use of a port control, a second 
set of characters is available. The port output functions as a hard- 
ware mask, and activation of the alternate character generator is 
made through port control as will be described in the next section. 
The characters that are available consist of the standard upper- and 
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lower-case alphabet, some Japanese symbols or character sets, the 
Greek alphabet, Spanish, French, and German accents and mark- 
ings, and other special graphics and symbols. Figs. 1-6 and 1-7 dis- 
play the complete character sets available. The set shown in Fig. 1-6 
occurs when bit 3 of port ECH is low, while the set shown in Fig. 1-7 
occurs when bit 3 of port ECH is high. The two sets of characters 
are displayed, including graphics. Notice there is considerable dupli- 
cation, particularly in the alphabetic character set. The graphic char- 
acters are the same as those used in the Model I, but logic 1 in the 




Fig. 1-6. Character set available with bit 3 port ECH low on TRS-80 Model III. 

most significant bit position is not used. Instead, these characters are 
displayed by outputting the hexadecimal values 80H (a graphic 
blank ) through BFH ( full white ) . The least significant bits control 
the 64 patterns identical to the patterns formed in the Model I sys- 
tem. The enhanced or extended size is also available, but the ports 
used to enable this function and test the mode activation flag are 
changed. 

Keyboard Input 

Only one change is made on the keyboard logic, and it aflFects the 
data available on the data lines when the location 3880H is ad- 
dressed. The right shift key data appears on bit 0, and the left shift 
data appears on bit 1, instead of both on bit as in the Model I 
system. As a result, there are additional decoding capabilities and 
more control characters possible on the Model III system. 
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Fig. 1-7. Character set availabre with bit 3 port ECH high on TRS-80 Model III. 

Tape I npuf /Output 

Cassette tape input and output is controlled by port FFH. The 
bits used for reading and writing are the same as those used in the 
Model I system, but the remaining bits of port FFH do not provide 
the same functions. The cassette is capable of operating at a data 
rate of 1500 b/sec using the improved hardvi^are support on the 
Model III. 

Interrupts 

Hardware has been included to allow the use of all the interrupt 
features of the Z-80 processor. It is not necessary to use this hard- 
ware. The interrupts are possible using all three modes (0, 1, and 2) 
without any hardware modifications. 

MODIFICATION OF THE TRS-80 

We have two methods of modifying the TRS-80 into a develop- 
ment system. 

The first involves only software. By simply loading the monitor 
from tape into available read-write memory and using the SYSTEM 
command available on Level II machines, all commands in the 
FROLIC monitor are available. This modification is only possible 
for the Level II machines, since no method exists for setting break- 
points in a Level I unit. 

The second method involves the replacement of the BASIC ROMs. 
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This replacement means the loss of the BASIC programming fea- 
ture. These ROMs are replaced with a single programmed EPROM 
containing the FROLIC monitor. Because of the hardware differ- 
ences between the Model I and Model III systems, these EPROMS 
are not interchangeable. For a successful modification it is necessary 
to have the correct EPROM. The source codes of the two variations 
of the monitor are listed in Appendixes D and E. To replace the 
ROMs with the single EPROM, the seal on the unit must be broken. 
Because the warranty is now voided, there will be an additional 
charge levied by Radio Shack if service is required on the system. 
To remove the BASIC ROMs, the following procedure must be 
followed. It is necessary that a 2716 EPROM be available pre- 
programmed with the correct version of the monitor. This EPROM 
may be purchased from the supplier listed in Appendix C or pro- 
grammed from the source listings given. An EPROM programmer 
facility is available with the new monitor, but it is not available 
until the modification is made. If one starts with a cassette contain- 
ing the monitor and builds the EPROM programmer described in 
Chapter 4, the task is simplified. With the programmer, burn in a 
clean 2716 EPROM with the object code for the Model I system. 
You now have the monitor in EPROM ready for insertion. This 
EPROM must be the single, 4-5 volt variety. It is important that 
you program the correct program for the model you are modifying. 
If you are modifying a Model III, go to the section that deals with 
the modification of that system. 

Modification of the Model I 

To modify the TRS-80 Model I, the removal and replacement of 
the BASIC ROMs is necessary. The TRS-80 keyboard must be 
opened. To do this, place the keyboard unit face down and remove 
the six Phillips type screws located on the underside of the keyboard. 
A metalized paper seal may be hiding one of these screws, so be 
sure you have removed six of them. After removing the screws, 
carefully place the keyboard unit face up, and then lift the top cover, 
exposing the bare keyboard. With extreme caution, so as not to 
damage the flexible connector between the keyboard and the CPU 
board, lift the keyboard in a manner somewhat similar to the open- 
ing of a book. Unfold the board toward you with its bound axis 
parallel to your chest. Fig. 1-8 shows the exposed computer board. 
You should see five soft plastic spacers that must be lifted while 
balancing the keys in one hand. Be careful not to lift the bottom 
plastic protective cover, as this may place undue strain on the very 
sensitive connection between the two printed circuit boards. After 
the plastic spacers have been removed, carefully lift the CPU board 
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Fig. 1-8. Circuit board layout for TRS-80 Model I. 

from the bottom plastic protective cover. Once again try not to lift 
the entire unit because of the strain this imposes on the interconnec- 
tion. After successful separation, lay the keyboard and CPU flat on 
a protective, nonconductive surface. I have spent many hours oper- 
ating the computer in this position, and vsdth reasonable care no 
damage will come to the unit. 

In a Level I unit and a late model Level II, there is no umbilical 
cable to the electronics supporting the BASIC ROMs. It is assumed 
you have such a machine in front of you. A foUovs'ing paragraph will 
describe the procedure for those units with attached ROMs. Simply 
remove the two ROMs located in the center of the unit. They are 
identified by the small letters Z-33 and Z-34, most likely above and 
to the right of the ROM sockets. Fig. 1-9 shows an enlarged view 
of the two ROM sockets with the FROLIC monitor EPROM in 
place. Note carefully the position of pin 1 on the ROM chips. (Fin 1 
is on the end of the chip that is notched or marked in some other 
way. As showna in Fig. 1-9, pin 1 is always to the left of the notch. ) 
Also, make a careful note of the position of the ROM. Mark it if 
necessary on the printed circuit board using a grease pencil, an 
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Fig. 1-9. Detail o* ROM placement in a Model I TRS-80. 

adhesive label, or any other convenient, nonconductive method. 
The ROMs are generally tight in the socket, so remove them with 
great care by prying up evenly on both ends. 

If the unit you are modifying is a Level I, the new 2716 EPROMs 
can be placed in either socket position and still operate correctly. 
If you are modifying a Level II, then place the preprogrammed 2716 
in socket Z-33. Since this application only requires one EPROM, no 
conflict exists in the memory space. However, it is not possible to 
have two 2716s reside in both sockets at the same time and have the 
memory space contiguous. That is, there must be a 2K break be- 
tween the two memories. The select logic for the BASIC ROMs 
along with the general decoding logic is the final topic of this chap- 
ter. Let it suffice to state that if one desires to use the 4K or 8K 
total ROM space available in one socket, it is recommended that a 
2732 EPROM or 2764 EPROM (single voltage) that occupies only 
one socket be used. Other possibilities exist and will be covered. 

After making sure the EPROM is properly installed, it is possible 
to test the unit by attaching all the connecting cables. Be very care- 
ful, since connector orientations are different from what they are in 
the closed operating condition. The DIN plug closest to the center 
of the board is used for the power supply. The center DIN plug 
connects the monitor, and the DIN plug at the outer edge is used 
for the cassette player. All should test successfully with the prompt 
"FROLIC:" appearing at the bottom extreme left of the screen. If 
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this does not occur, replace the BASIC ROMs and check the unit. 
If the unit operates correctly, the EPROM containing the monitor 
is at fault, in which case it must be reprogrammed or replaced. 

The modification of a Level II machine with the slave memory is 
almost identical to the procedure used in altering the Level I unit. 
In these earlier units, there is an umbilical plug connecting one of 
the ROM sockets to the supporting electronics containing the Level 
II BASIC ROMs. In addition, there are some extra wires used for 
addressing. These vwU not cause trouble when the umbilical plug is 
removed from its socket. Protect the plug on the end of the cable 
by any convenient method. Some electrical adhesive tape may be 
used to achieve isolation of this connection. Proceed as in the Level 
I modification by inserting the programmed EPROM into socket Z- 
33 of the two available sockets, and test the system. 

Interrupt and Halt Modifications— A third method of modification 
is merely an extension of the second method in which the mode 1 
and mode 2 interrupt feature, as well as the HALT feature, of the 
Z-80 microprocessor is enabled. In order to obtain this flexibility, 
the Z-80 microprocessor chip (the only 40-pin device in the key- 
board unit, labeled Z-40) must be removed and altered. 



Fig. 1-10. Z-80 modifications for halt 
and interrupt features. 




If you wish to obtain the full interrupt feature, remove the Z-80 
microprocessor from its socket. The BUSRQ/ pin (number 25) must 
be bent outward with great care. Between pin 25 and pin 11, the 
+5 V dc line, you must attach a 4700 ohm, ¥4 watt, 5% tolerance 
pull-up resistor. Fig. 1-10 shows this modification. With this altera- 
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tion complete, all interrapt features of the Z-80 microprocessor are 
now available. 

As mentioned earlier in this chapter, the HALT mnemonic is not 
available to the user in the unaltered TRS-80. The designers of the 
TRS-80 chose to take the halt acknowledge signal (HALT/) and 
gate it into the nonmaskable interrupt (NMI/) input. To enable 
the use of the HALT instruction, this line must be removed. The al- 
teration is possible using the same technique used for engaging the 
full interrupt feature. In this case, microprocessor pin 18, HALT/, 
is bent outward. Between pin 18 and pin 11, the +5 V dc line, attach 
a 4700 ohm, Vi watt, 5% tolerance resistor. This leaves a floating 
input to Z53 (74LS132), a quad 2-input nand Schmitt trigger. There 
is no problem with the floating input, since the other side of that 
gate is tied to the +5 V supply. If this makes you uncomfortable, 
tie pins 1 and 2 of Z53 together. The two modifications described 
give the user complete control in the implementation of all the 
Z-80 features. 

Note that the original Z-80 could be saved and a second Z-80 mi- 
croprocessor chip could be altered using the pull-up resistors and 
pin 11 for sourcing the 5 V dc supply. If one is careful with his 
soldering procedure, no damage will be inflicted upon the micro- 
processor. Fig. 1-10 shows a possible arrangement and sequence of 
attaching these pull-up resistors. If repair is required to the TRS- 
80, the original Z-80 may be inserted into the 40-pin socket, and 
there will be no visible evidence of any alteration except the obvious 
broken seal on the protective cover. 

Memory Decode Logic— li all the alterations described have been 
completed, the transformation of the TRS-80 to a development sys- 
tem is now complete. However, some words are necessary about 
memory expansion to this basic unit if expansion to the full 16K 
is desired. An understanding of the operation of the dynamic RAMs 
used in the TRS-80 units is necessary to aid in your modifications 
to the memory system. 

First, consider the hardware conveniences supplied with Model I, 
Level I and Level II units that overlap both ROM and RAM ad- 
dressing capabilities. There are two DIP shunt sockets, X-3 and 
X-71, located inside the keyboard unit. (They may be labeled Z-3 
and Z-71 on the circuit board. ) It was suggested earher that you re- 
place these shunts with DIP switches. See Fig. 1-11, which shows 
these two switches relative to the Z-80 microprocessor. Through 
various switch combinations, the memory may be configured in a 
variety of combinations. 

The memory mapping of the lower 32K (the total available mem- 
ory space within the keyboard unit) is controlled by the two DIP 
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Fig. 1-1 1. Switch socket positions of DIP shunts X-3 and X-71. 

shunts shown in Fig. 1-11. DIP shunt X-3 is located to the right of 
the memory near the reset button. DIP shunt X-71 is located near- 
est the ROM sockets. The distinctive style of these packages makes 
it impossible to overlook them. 

The function of X-3 is address decoding. The 32K of memory is 
segmented into 4K blocks through the use of a dual 2-input to 4-line 
decoder/ demultiplexer (74LS156). This device is configured to func- 
tion as a l-of-8 decoder of address lines A14, A13, and A12. Address 
line 15 is used to select this chip when the computer is accessing 
the lower 32K of memory. The HAS/ (row-address strobe, active- 
low), which is in fact the MREQ/ (memory-request signal, active- 
low) from the Z-80 microprocessor, also is used to activate address 
selection. Fig. 1-12 shows the significant features of the address 
select decoder. The exact diagram is obtainable from the TRS-80 
technical manual, which is needlessly complex for the presentation 
here. 

The 32K block can be subdivided further into the upper 16K block 
and the lower 16K block. Address selection for the upper 16K block 
is straightforward. When the appropriate connections are made on 
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Fig. 1-T2. Address selection of lower 32K memory. 

the DIP shunt, 4K blocks are selected to activate the MEM/ line 
which enables the memory present in the sockets to be available 
to the Z-80 microprocessor data lines. Three types of dynamic RAM 
devices can occupy the eight sockets: 4K X 1 RAMs, 8K x 1 RAMs, 
or 16K X 1 RAMs. Selection of the amount of RAM is controlled 
by DIP shunt X-3, while the shunt at X-71 determines the size of 
dynamic RAM which may be placed in the memory sockets. Table 
1-4 shows the connections to be made to determine how the upper 
16K of RAM is accessed. 

Read-Only Memory Expansion-The lower 16K of address decod- 
ing is not as simple, since there is a great deal of flexibility over the 
use of this space. Only three of the four 4K blocks are available at 
the DIP shunt. The missing block address space 3000H to 3FFFH 
is not present. You should recall that this block of memory contains 
the video and keyboard addresses. Even though it would be nice 
to place a monitor in part of this unused space, it would require spe- 
cial decodine; to accomplish this. The other three 4K blocks are the 
first 12K of ROM that is used to support the Level II BASIC, or the 
4K Level I BASIC. Because this ROM has been made available in 
a variety of IC packages, Radio Shack provided some flexibility in 
the use of the lower 12K. DIP shunt X-3 also controls how the two 
ROM sockets are addressed, since these sockets may hold IK, 2K, 
4K, and 8K ROM devices. For convenience, socket Z-33 is called 
ROM A, and socket Z-34 is called ROM B. DIP shunt X-3 now takes 
on the significance shown in Table 1-5 in addressing this memory. 



Table 1-4. Shunt Connections for X-3 to Allow for 4K R/W 
Memory Selection 



From Pin 


To Pin 


Addresses 


2 


15 


1st 4K 4000Hto4FFFH 


3 


U 


2nd 4K 5000Hto5FFFH 


4 


13 


3rd 4K 6000Hto6FFFH 


5 


15 


4»h 4K 7000Hto7FFFH 
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Table 1-5. Shunt Connections for X-3 to Allow for 4K ROM 
Memory Selection 



From Pin 


To Pin 


Address 


1 


16 


1 St 4K ROM B OOOOH to OFFFH 


7 


10 


1 St 4K ROM A OOOOH to OFFFH 


8 


9 


2nd 4K ROM A 1 0OOH to 1 FFFH 


6 


11 


3rd 4K ROM B 2000H to 2FFFH 



Notice that a 2K ROM could be plugged into socket Z-33 and 
Z-34 as is done on some Level I units. Logic internal to the ROM 
itself used for address selection prevents conflict in this address space 
and is independent of which socket holds the OOOOH address as long 
as shunt strapping allows access to the correct location. This is ac- 
complished in the Level I units by strapping pins 1 to 16 and 7 to 10 
at shunt X-3. 

It is also possible to use a single 4K ROM, and again it could be 
placed in either socket. In both cases the DIP shunt connections 
between pins 1 and 16 and pins 7 and 10 are shorted. Only one such 
device is allowed if the shunt is so configured. One can be selective 
as to which socket is used by controlling the DIP shunt strapping. 
This is the preferred method of ROM selection. 

An 8K ROM can be placed in Z-33 with the appropriate closures 
between pins 7 and 10 and pins 8 and 9 made at the X-3 DIP socket. 
However, if the 8K ROM is placed in Z-34 (the adfacent ROM 
socket holder), the switch does not provide for all the necessary 
closures using the DIP shunt. By using jumpers to make connec- 
tions between pins 1 and 16 and between pins 9 and 11 (t^-is is 
necessary, for both pins are on the same side of the dual-in-line 
configuration), one can address the first 8K of ROM using socket 
Z-34. It is interesting to note that Radio Shack originally found it 
to be less expensive to add the external ROM printed circuit board 
for the 12K BASIC ROMs than to manufacture 8K and 4K ROMs 
for use in these on-board sockets. The addressing capabilities are 
there to use. The potential provided in this home computer by mak- 
ing use of customized ROMs is exciting and worth expanding. 

Read/ Write Memory Expansion— The control over addressing the 
dynamic RAMs that are compatible with the TRS-80 keyboard unit 
is provided by the DIP shunt in position X-71. To understand its 
function it is necessary to look at the dynamic RAM pinout of the 
series suitable to operate in these sockets, as shown in Fig. 1-13. 
Two types of RAM can be used in this unit. They are 1 bit wide, 
and hence eight devices are required for the addressed word. The 
"length" of dynamic RAM installed can be 4K or 16K. Although it 

43 



RA5 4 
A, [71 



FIN CONFIGURATiON 

— rr— 



LOGIC SYMBOL 



11 Aj 

j lOJ A5 

9] Vcc 




A^Aj ADDRESS INPUrS 

CAS COLUMfi AOORESS STROBE 

C5 CHIP SELECT 

0,.i OATA m 

Oqu; OATA out 

HAS ROW ADDRESS STROBE 



WE WRITE ErjABlE 

Vgg POWER {-5V} 

Ucc POWER (+5V) 

Vpo POWER i + 12V) 

Vss GROUtJD 



(A) 2104A4KX 1- 



m CONFIGURATION 





«0 
A, 






13 
Aj 






HAS 


Oout 




CAS 






WE 





'fioie S50DQ. S6002. Ag ai Vm duting fow address valicj 
S600!, Se003. A5 ai V,,^ duftng fow address valid. 

PIN HAMES 



Ag->lg H 



ig ADDRESS llfPUTS WE WRITE ENABLE 

CAS COLUMN ADDRESS STROBE V^g POWER i-5Vi 

Oj,j OATAIH Vcc POWER !+SV} 

DGi,TW^*^OyT VpQ POWER i4-12V) 

RAS ROW ADOTIESS STROBE Vss GROUND 



{B)2109 8Kxl- 
Fig. 1-13. Logic symbols and pin configurations for 



44 



is possible to use 8K dynamic RAM, there is a problem with the 
installation of these memories because two versions of this memory 
are available. Details for installation of all of the memories are 
given. Notice in Fig. 1-13 that only pin 13 shows a change. If 4K 
devices are used, then pin 13 functions as a chip select (CS/ ). For 
8K devices this pin functions as an address input and chip enable. 
With 16K devices the chip enable availability is lost, but no serious 
problem results. Because of these few differences, each memory 
group size is considered separately. The DIP shunt arrangements 
given for each group can be seen in Table 1-6. 

Table 1-6. Dip Shunt Connections on X-71 for Dynamic 
R/W Memory Selection 

(Check X-3 for absolute address and range.) 



4KRAM 


16K RAM 


8K RAM (Lower) 


8K RAM (Upper) 


2-15 


1-16 


1-16 


1-16 


4-13 


3-14 


3-14 


3-14 


6-11 


5-12 


5-12 


5-12 






8-9 


7-10 



Because of the large address space accessed, it would not be 
possible to address 4K of memory with only six address inputs. 
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dynamic RAM memory in the TRS-80 microcomputer. 



45 



Hence, multiplexing the address lines using the RAS/ (row address 
strobe, active low) and CAS/ (column address strobe, active low) 
allows 12 address inputs and consequently the ability to address 
4096 memory locations. The address bit assignments AO, Al, A2, 
etc., are arbitraiy, and any order of addresses placed on these pins 
would result in a unique location being accessed. Multiplexing a 
12-bit address to 6 lines is accomplished with two quad 2-to-l multi- 
plexers (74LS157). Arrangement of the shunts at X-71 determines 
the size of memory addressed. In this case, the addresses AO, Al, 
A2, A3, A4, and A5 are strobed during the RAS/. During the column 
address strobe (CAS/ ), A6 is directed to the AO input, A7 to the Al 
input, AS to the A2 input, A9 to the A3 input, AlO to the A4 input, 
and All to the A5 input. The CE/ (chip enable, active low) is made 
available from RAM) (memory decode, active low). DIP shunt X-3 
selects the appropriate 4K block. In most systems, including the 
monitor, this is the 6rst 4K block from 4000H to 4FFFH. However, 
any 4K block could be selected as was shown using DIP shunt X-3 
in Table 1-4. The strappings for DIP shunt X-71 for dynamic mem- 
ory selection are shown in Table 1-6. 

Memory addressing for the 16K devices replaces the CE/ line 
with A6. With this addition of another pin for addressing, 14 ad- 
dress bits can be strobed into the chip memory latches, which re- 
sults in 16.384 locations being accessed. The CE/ function for these 
memories is combined with the RAS/. The additional external hard- 
ware to provide for the decoding is minor when compared to the in- 
creased memory capacity. The DIP shunts at X-71 must be changed 
to reflect the insertion of the larger memory chips. The new posi- 
tions are shown in Table 1-6. By installing 16K RAMs into the TRS- 
80, the DIP shunt routes address line A6 to the A6 input (formerly 
the CE/ of the 4K memories). This address is strobed along with 
the other addresses during the RAS/ activation. However, during 
the CAS/ activation A13 is directed to AO, and A12 to A6. All other 
addresses, A7 through All, remain the same as those strobed with 
the 4K devices during the CAS/ activation. An examination of Ta- 
ble 1-6 should help to clarify the addressing scheme for each of 
these different types of RAMs. 

The 8K dynamic RAMs present another variation for the AO input. 
In this case the AO line is used to strobe the operating half of a 16K 
dynamic RAM. It is not clear why this method of 8K implementation 
is used. Intel Corporation supplies an 8K dynamic RAM that uses the 
A6 input during the CAS/ to function as a chip enable. Two versions 
are available, one in which the memory device is enabled with this 
line input low, and the other when this line input is high. Thus the 
chip enable feature is still provided for in the 8K device. If A6 is 
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low, the lower 8K is addressed; if it is high, the upper 8K is ad- 
dressed. The unique location is determined by the logic levels 
strobed with the other address lines. (It appears that these de- 
vices are fallouts from the manufacture of 16K memory.) DIP 
shunt X-71 makes provision for a logic high/ low not for pin A6 
but for AO. It seems that Radio Shack was going to have an 8K 
RAM manufactured with this specification. One assumes that be- 
cause of the low cost and availability of 16K memory, making cus- 
tomized versions of 8K devices became prohibitively expensive, and 
the scheme was discarded. If an 8K dynamic RAM system is de- 
sired, this can be accomplished through the use of the 16K mem- 
ories. This will allow 8K of additional ROM within the keyboard 
unit. You must supply your own hardware to decode the ROM ad- 
dress space. DIP shunts on X-71 provide for either the low or high 
addresses on A13. Memory not to be accessed may be isolated with 
DIP shunt X-3. Few systems have been modified to use 8K of RAM. 
However, the electronics for such a conversion is present, in this un- 
orthodox fashion. Table 1-6 lists the DIP shunt selections possible 
for an 8K implementation. Do not forget to make the appropriate 
range selections with X-3. 

To clarify further the address data on the dynamic RAM pins 
during the RAS/ and CAS/, Table 1-7 is provided. 

Modification of the Model III 

To modify the Model III, the ROMs must be removed from the 
desk-top unit. To accomplish this, rest the unit on its back or top, 
protecting the surface with a soft cloth or foam padding. There are 
10 Phillips screws surrounding the outside of the Model III. Do not 
remove the screws in the plastic feet. The function of the feet is to 
support the unit and prevent marring. They do not retain the cover 
and will have no effect on the disassembly. Remove the 10 screws 
at the outer edge. You will notice that these screws have different 
thread styles and lengths. The three shortest have machine threads 
and are in the front holding that portion of the case that covers the 
keyboard. Behind these, toward the edge and in line with the front 
of the crt structure, are two longer machine-thread screws. These 
screws are in a well about % inch deep. The remaining five screws 
are 1-inch sheet-metal screws. One of these screws may be covered 
with the seal that refers to the warranties. The breaking of the seal 
will result in an additional service charge if the unit is to be re- 
turned for repair. (If this unfortunate event should occur, do not 
forget to restore the original ROMs in the unit. ) After the 10 screws 
have been removed, do not lift the base because there is one more 
retaining screw holding the cover in place. The final screw that must 
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Toble 1-7. Pin Assignments and Signals Present on Dynamic 

R/W Memory 



Pin Assignment 


RAS/ 


CAS/ 4K 


RAS/ 8K a 16K 


CAS/ 8K 


CAS/ 16K 


5 AO 


AO 


A6 


AO 


Gor +5 


A13 


7 Al 


Al 


A7 


Al 


A7 


A7 


6 A2 


A2 


AS 


A2 


A8 


A8 


12 A3 


A3 


A9 


A3 


A9 


A9 


11 A4 


A4 


AlO 


A4 


AlO 


AlO 


10 A5 


A5 


All 


A5 


All 


All 


13 CE/orA6 


RAM/ 


RAM/ 


A6 


A12 


A12 


1 Vbb 












2 DIN 












3 WE/ 












4 RAS/ 












8 Vdd 












9 Vcc 












14 DOUT 












15 CAS/ 












16 Vss 













be removed is in the top center of the back of the unit. In the in- 
verted position, this screvi^ is in the center back near the resting sur- 
face. Remove this last screw, and carefully lift the base from the top 
cover. The top cover holds the crt and associated electronics and is 
attached to the main base with a long connecting cord. Lift the base 
vertically high enough to clear the circuit board from the neck of 
the crt and the cover. The base is light, so with reasonable caution 
no problem will occur. After you are certain of being clear of the 
top cover, rotate the base by 180 degrees and set it on its plastic 
feet. The removal of the BASIC ROMs can now take place. 

Facing the unit from the rear, you will notice in the lower right- 
hand comer three large 24-pin dual in-line integrated packages 
(refer to Fig. 1-14). These are the three ROMs that contain the 
Level II BASIC. If the Model III is a Level I, there will be only one 
socket of the three filled, the extreme left socket. Fig. 1-15 shows 
an enlarged view of the ROM sockets with the FROLIC monitor 
in place. These sockets are labeled U104, U105, and U106. The 
socket closest to the cassette plug is U106, the system utility ROM. 
The memory capacity of this IC is 2K X 8. The center socket, U105, 
can hold a 4K X 8 ROM. The left socket is U104, and it resides at 
the starting address, OOOOH. In a Level I system the size of this ROM 
is 4K X 8, and in a Level II system it is 8K X 8. It is this ROM that 
must be removed to reconfigure the TRS-80 into the FROLIC de- 
velopment system. Therefore, remove it, but note the position of 
pin 1, which is in the top left comer of the package. The ROM will 
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Fig. 1-14. Circuit board layout for TRS-80 Model III. 







Fig. 1-15. Detail of ROM placement in a TRS-80 Model III. 

be tightly pressed into its socket, so remove it with great care using 
a sma.ll flat-blade screwdriver which allows you to get between the 
ROM and the socket for greater leverage. After the ROM has been 
removed, you are ready to replace it with a 2716 EPROM obtained 
from the supplier listed in Appendix C or with a 2716 EPROM that 
you have programmed using the object code given for the Model III 
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in Appendix E. Pin 1 is inserted in the upper left of socket U104. 
However, with a 2716 EPROM, one precaution must be observed. It 
is necessary to raise pin 21 to +5 V do to enable the chip at addresses 
that start with location OOOOH. This is accomplished by making 
a connection between pin 24 (the Vcc) and pin 21. This can readily 
be observed in Fig. 1-15. The ROM supplied from the listed source 
has this jumper in place. Pin 21 must be (or is) bent shghtly out- 
ward so that it will not be pressed into the socket when it is inserted. 
It is possible to place either a 2732 (4K X 8) or a 2764 (8K X 8) 
EPROM in this socket. The 2732 and 2764 do not require a jumper 
wire. (A note of caution concerning the 2716. If it is necessary to 
reprogram this EPROM, do not attempt to program the 2716 with 
this jumper in place.) 

The Model III may be tested with the cover off. After the EPROM 
is in place, place the crt screen in a position so you can see it. Turn 
on the unit with the switch under the keyboard on the right. The 
"FROLIC:" prompt should appear on the lower left of the screen. 
If not, replace the original ROM, and try the unmodified system. 
If all is well, as it should be, the fault is in the EPROM. Return it 
to the supplier, or check the object code against the listings for the 
Model III unit given in Appendix E. 

Unlike the Model I, full memory expansion is provided for on the 
microcomputer circuit board. In the upper right comer are sockets 
for 24 dynamic R/W memory devices. The first row may take eight 
of either the 4K X 1 or 16K X 1 dynamic RAM devices. If the unit 




Fig. 1-16. Dynamic R/W memory placement in the TRS-80 Model III. 
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Fig. 1-17. Jumper placement for 4K 

and 16K memory selection in TRS-80 
ki^j^i III 





n 



Model III. EE I I 





D 



GG 

16K MEMORY 



is a Model III Level I, the 4K devices are residing in the upper row, 
vs^ith all other socket holders empty. To convert to a 16K machine, 
it is necessary to change the address select and chip enable of this 
first row. This is accomplished by special jumpers to the left of the 
memory. Refer to Fig. 1-16, in which the jumpers are shown near 
socket U-7 and near RP-3. The upper jumper is labeled, from top to 
bottom, S, T, and U. The lower jumper is labeled EE, FF, and GG. 
For 4K memory, T is jumpered to U with S open, and FF is jump- 
ered to GG with EE open. For 16K memory, S is jumpered to T 
with U open, and EE is jumpered to FF with GG open. Fig. 1-17 
shows the placement of the jumpers for the two types of memory 
that may occupy the first row. 

The memory can be expanded to the full 48K capability by filling 
the remaining 16 RAM sockets with 4116 dynamic memories. The 
jumpers to the left of memory should be in the 16K position as 
shown in Fig. 1-16. 

CONCLUSION 

The information provided in this chapter is to aid in understand- 
ing the TRS-80 system. To some readers the material may appear 
too complex, and to others not complex enough. Attention was given 
to memory utilization, input through the keyboard, output to the 
crt, and tape storage techniques. The software provided requires 
some knowledge of these system components. It is also hoped that 
the potential for this low-cost microprocessor development system 
is realized. Its uses may be far removed from those envisioned by 
the TRS-80 system designers. 
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The intent of this book is to provide the software to obtain a so- 
phisticated monitor operable on the TRS-80 system. The software 
is given in the Appendixes. Chapter 2 describes the command set 
of this monitor. 
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CHAPTER 2 



The Monitor 



The FROLIC monitor transforms the TRS-80 microcomputer into 
a sophisticated and manageable development system. The monitor 
allows the user to interact directly with the TRS-80 at the machine- 
language level, to enter and execute machine-language programs, 
to read and write machine language tapes using audio cassettes and 
a recorder, to use editing and debugging facilities, and to program 
several of the currently popular and readily available programmable 
read-only memories (PROMs). 

The monitor is intended to replace the first 2048 (2K) bytes of 
read-only memory currently residing in any of the TRS-80 Model 
III and Model I microcomputers. An EPROM is used for this re- 
placement. Alternatively, the monitor program may be entered into 
memoiy using a cassette as presented in Chapter 1. The advantage 
of ROM replacement is that this allows instant availability of the 
monitor on power-up. 

COMMAND FORMAT 

Most commands are designed to be single-character commands. 
Up to three hexadecimal addresses may follow a command. In this 
text the hexadecimal representation is always indicated by the pres- 
ence of a terminating upper case H with the only valid address digits 
being through 9 and A through F. Likewise, decimal addresses 
terminate with an upper-case D with the only valid entries being 
the digits through 9, and binary addresses terminate with an upper- 
case B with the only valid entries being or 1. Upon entering a com- 
mand, addresses and address data are separated by spaces with the 
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first space being optional. The letter "T" is used to separate ad- 
dresses, as though the "T" represents "through." The command for- 
mats that represent typical command entries into the monitor are 
shown in Table 2-1. 



Table 2-1. Typical Monitor Command Instructions 


Command 


Definition 


C 


No address required 


D40 


0040H is the only address affected 


D4000 


4000H is the only address affected 


D4000T4040 


4000H through 4040H is affected 


D4000 40 


40H or 64D positions are affected, an alter- 




nate form of the preceding 


M4000T4040 5000 


Three fields are the maximum 


M4000 40 5000 


An alternate form of preceding format 


D934000 564040 


Equivalent to D4000T4040 or D4000 4040 



Note that: 

A. Commands may not need addresses. 

B. Leading zeros are optional. 

C. Leading spaces are optional, and only the first occurrence is 
used for separation of address or data fields. 

D. If more than four hexadecimal numbers are entered together, 
only the last four are recognized. 

E. If the T delimiter is not used, spaces may be used instead with 
the first address indicating the initial address and the second 
hexadecimal value representing the number of positions af- 
fected, first address inclusive. 

F. If entered addresses or address data is separated by a letter 
other than T or a space, the command is ignored. 

COMMAND EXECUTION 

All commands are executed by depressing the <ENTER> key. 
Editing of a command or command sti'ing is done through the use 
of the left arrow key for backspacing, which allows you to "back up" 
to the error for correction. Command editing may be continued until 
<ENTER> is finally depressed. 

The monitor for the TRS-80 is described in the text that follows. 
At the end of the text, documentation is included to enable you to 
modify any of the subroutines to fit your particular purposes. Expan- 
sion to 26 commands is possible, one for each letter of the alphabet. 
In addition, the "at" @ is included, for a total of 27 commands. Most 
commands utihze a letter that is close to describing the desired com- 
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mand. For example, to display a section of memory the upper-case D 
is used, indicating "Display." Also, depending upon the command, 
up to three data fields are required. Certain formats are used to spec- 
ify ranges of addresses that occur in these commands. A great deal 
of effort was made to be consistent. 

Monitor operation is indicated by the initial "FROLIC:" prompt. 
This "sign-on" appears in the lower left area of the screen, at the 
beginning of the sixteenth line. If this is not the case, resetting the 
CPU using the reset button should result in the display of the 
prompt. 

Table 2-2 shows a list of the 27 possible commands. Each com- 
mand is described in the text that follows. 

Table 2-2. List of Available Commands in the FROLIC Monitor 



Command 


Definition 


@ 


Fill memory with constant 


A 


ASCII display of memory specified in command 


B 


Repeat last command saved in buffer 


B{S) 


Save command string and execute with a B command 


C 


Clear screen 


D 


Display memory in hexadecimal format in range specified 


E 


Execute with current screen data 


F 


Used for searching for a single byte of data over the range 




specified 


G 


Go and execute the program starting at specified address 


H 


Hexadecimal sum and difference 


1 


Insert data from command string 


J 


Not used 


K 


Not used 


L 


Produce hard copy on listing device (if this option is 




loaded)* 


M 


Move memory data from one location to another 


N 


Input data from input port(s) 


O 


Output data to port specified 


P 


Program PROM (if option loaded)* 


' Q 


Search memory for a two-byte word in INTEL format, low 




byte followed by high byte 


R 


Read cassette tape using Radio Shack 500 bits/second 




format 


S 


Substitute to memory from keyboard input 


T 


Transfer data from previously allocated screen storage to 




crt display 


U 


User assignable* 


V 


Verify memory 


W 


Write a cassette tape using Radio Shack 500 bits/second 




format 


X 


Examine and alter Z-80 registers 


Y 


Not used 


Z 


Single-step (hardware must be implemented)* 



*The implementation of these commands is described in text. 
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Commands are executed from a bufFer. When any key is pressed, 
its ASCII (American Standard Code for Information Interchange) 
value will be stored in this buffer. Multiple commands may be en- 
tered by separating each command by a comma. The buffer is lo- 
cated starting at address 4080H and ending at address 417FH. 

For proper command execution, the correct format must be en- 
tered. If you fail to enter the correct format, execution is attempted, 
but it will cease when an unexpected character is encountered. At 
this time, the complete command buffer is displayed with a "?" over 
the nonexecutable entry. If possible, any additional commands that 
remain io the command buffer will be executed; otherwise execu- 
tion stops. The prompt reappears, and the correct format of the 
command must be entered. Editing of the line is possible until 
<ENTER> is depressed. You can "escape" from the command se- 
quence executing by actuating the <BREAK> key. Then the com- 
puter will indicate that the monitor is ready to accept a new com- 
mand. 

To use the monitor, it is necessary to specify a command and 
where necessary specify the data fields describing the extent of op- 
eration of the command. Each command has its particular field 
specification. In some cases similar formats occur in several of the 
command fields. For example, both the A and D commands require 
a beginning address and a specification for the number of bytes to 
be displayed. If an error is made in the entry, it is only necessary to 
use the backspace arrow to "rub out" the last entry or entries and 
insert the correction. In any address or address field, only the last 
four hexadecimal digits are accepted as valid data. 

Assume you have entered a command and it is executing, and you 
wish to halt or abort the command. The process may be halted by 
pushing down and holding down the space bar. This stops execution 
for as long as the space bar is depressed. To stop execution com- 
pletely, simply depress the <BREAK> key. The "FROLIC:" indi- 
cates that the monitor is ready for its next instruction. 

There are five delimiters or separators used in this monitor. The 
space " ", the "T", the period ".", the comma ",", and the slash "/". 
Other characters of the ASCII set used are the <ENTER> or car- 
riage reharn (CR or ODH), and start-of-heading (SOH or OIH). 
The <ENTER> is reserved to indicate to the monitor the command 
string is to be executed. Hidden from the user's view is OIH, which 
is used by the monitor to iadicate that the last command in the se- 
quence has been executed. The meaning of start-of-heading is im- 
portant, since the monitor detects the OIH value. The comma "," 
is used to separate commands. It is the only separator used for this 
purpose. You may observe this by noting the last entry in the buffer 
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when an error is encountered, for even though you depressed the 
<ENTER>, a comma terminates the command string. The period 
"." is used for the entering of data to be used as breakpoints. The "/" 
indicates an address change in both the substitute and insert com- 
mands. Particulars are covered in upcoming sections that deal with 
the command descriptions. 

Each command is described in detail. These are presented not in 
alphabetical order, but in a utilization order to allow you to start to 
use this monitor by knowing only a few commands. As with all pro- 
grams and systems, usage breeds familiarity. You should practice 
with a few commands and then add commands as needed. The table 
in Appendix A places the commands in alphabetical order for quick 
reference. 

S COMMAND 

The most flexible of the monitor commands is the S (Substitute) 
command. This command allows the user to insert data into mem- 
ory. When using this command an address is required in order to 
specify where substitution is to take place. The usual format is an S 
followed by an address. For example: 

S4400<ENTER> 

Execution of this command results in the display of the address, 
4400H, in the lower-left portion of the screen followed by a colon 
and the data currently located at that address. A question mark ends 
the sequence, prompting the user for an entry from the keyboard. 
The display resulting from the execution of the above command, 
S4400 <ENTER> is: 

4400: XX? 

(where XX is the hexadecimal data stored at 4400H) 

You may now enter data. Only valid hexadecimal data is accepted. 
To use this command, several choices are available. If no change in 
the data is desired, the user simply depresses the space bar. This 
advances the memory pointer to the next location. Valid hex data is 
entered by way of the keyboard, the last two hex digits before de- 
pressing the <ENTER> key replacing the memory contents. You 
may note that if an entry is made which is not hexadecimal, a "?" 
will appear. Any number of "?" symbols may separate the last two 
valid entries. It is not necessary to re-enter the command mode to 
change the address. It is only necessary to enter the new address 
followed by the "/" in place of the data. The new address location 
is displayed in the lower left-hand corner. Substitution of data may 
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now continue as before. It should also be noted that when data is 
entered into a memory location, that location is then re-read and dis- 
played as an "echo." This technique makes it evident that if data 
insertion is attempted in ROM or outside of valid read/write mem- 
ory, the echoed data will not agree with the desired data to be de- 
posited and, therefore, corrective action is required. Additional flex- 
ibility is demonstrated in that it is also possible to step backward 
using the back arrow or "rubout." If, while in the command entry 
mode a rubout occurs, in this case in the S command, the address is 
decremented by one and displayed along with the data currently 
residing at that location. To exit from the substitute command mode 
the <ENTER> key is depressed twice in succession. It should be 
pointed out that the double <ENTER> will not alter the contents 
of the last memory location. 

i COMMAND 

A second method is available to substitute data into memory using 
the I (Insert) command. For example: 

14400 00 11 22 33 44 4410/ AA BB CC<ENTER> 

As before, the beginning address of the substitution follows the I 
command. However, instead of using <ENTER> the user deposits 
the data in sequence. Each value is separated by a space, the delim- 
iter which is used after each data entry. The sequence continues for 
as many entries as desired. The execution of the I command shown 
in the example would result in the data OOH, IIH, 22H, 33H, and 
44H inserted in sequence starting at 4400H and ending at 4404H. 
Notice the next entry (4410/) is terminated with a "/", which 
changes the pointer, causing the insertion to continue at the new 
location. The data AAH, BBH, and CCH is inserted at 4410H 
through 4412H. After entry of this command, the display appears 
as follows: 

4400: 00 11 22 33 44 
4410; AA BB CC 

After the data is entered, you can see the displayed deposits when 
the command is executed by depressing <ENTER>. It should be 
noted that the question mark is not used in this command. The dis- 
play is similar to that obtained with the D command (which fol- 
lows). Like the S command, these deposits are echoed. If an attempt 
is made to deposit data in memory other than RAM, the display will 
reflect it. 
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D COMMAND 

After data is deposited using either the S or I command, you can 
examine this data through the use of the D (Display) command. A 
"D" followed by an address with no range specified results in the 
display of the data in 40H locations. A wider range of data can be 
observed by using a block format. A block is specified by first using 
a space as a delimiter after the start address is entered and then fol- 
lowing the definition with a value that indicates the block length. 
For example: 

D4800 10<ENTER> 

results in the display of 16 (lOH) memory locations. Block lengths 
up to FFFFH are possible. 

An alternative form of this command is to use the beginning ad- 
dress followed by a "T", then the ending address. The result is that 
the block is specified by the range of the entry. For example, the dis- 
play commands shown below result in a display of 40H locations 
beginning with address 4040H. 

D4040 T 407F<ENTER> 

or 

D4040 40<ENTER> 

Note that the space delimiters as shown on either side of the T are 
not required. The display that results after executing this command 
follows: 

4040: 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 

4050: 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 

4060: 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 

4070: 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 

G COMMAND 

After you examine your program in its hexadecimal form and you 
are convinced that the object code shown should run successfully, 
execution or testing is the next logical step in program development. 
This is accompHshed with the G (Go) command. The G command 
requires an address at which execution is to begin. This address can 
be specified as part of the command, or it can be obtained from the 
jjrogram counter register as saved from a iDrevious execution. In its 
most simple application, the G followed by an address causes execu- 
tion to begin at the address specified. You must be as sure as possible 
that when this command is executed your progi'am will not produce 
a system "crash," in which case the computer is advancing through 
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memory in an uncontrolled fashion, A reset will quickly return con- 
trol to the monitor program, but the contents of RAM, and as a eon- 
sequence, your program, may have been altered. As an example of 
the use of the G command, first insert the following object code by 
using the I command; 

14400 00 3E 2F AF C3 00 44<ENTER> 

The monitor responds with an echo of the object code at these 
addresses. 

4400: 00 3E 2F AF C3 00 44 

This code when executed using the G command does the following: 
the 00 is a NOP or no-operation (the program counter is advanced), 
then the computer loads the accumulator with 2FH, clears it ( which 
does affect the flag register), and then does this all over again, and 
again, and again. It will serve as an excellent demonstration for the 
G command. With the program in place, execute the following com- 
mand; 

G4400<ENTER> 

Nothing happened, or did it? First you will notice no prompt. Now 
you should also notice that there is no response to any key entry. 
What is happening is that the microprocessor is executing code that 
causes the computer to be in an endless loop. The only choice possi- 
ble for you at this time is to push the reset. You could use the power- 
on clear by turning the power off and turning it back on again. How- 
ever, the program you just entered would be destroyed because of 
the volatile nature of the dynamic RAM. 

Obviously, you would like to have more control over the execution 
of a program during the program development stage, and a con- 
trolled return to the monitor is desirable. This can be accomplished 
by means of breakpoints. Simply stated, a breakpoint in a program 
causes execution of your program to cease at a point you have speci- 
fied, and control is returned to the monitor. When control returns to 
the monitor, the states of all of the Z-80 registers are saved and then 
displayed immediately on the crt screen. The condition of the screen 
may also be saved, as will be shown later. Also displayed on return 
are the next four bytes which start with the data pointed to by the 
program counter. This code display occurs only when a breakpoint 
is encountered. You should also be aware that the code at the break- 
point is not executed. As will be shown later, the state of the registers 
is always available to the user upon request using the X command. 
If this request is made, the object codes starting at the breakpoint 
ARE NOT displayed. If the program terminated at a requested 
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breakpoint, execution can continue by entering "G" followed by a 
new breakpoint. You may have more than one breakpoint. 

To use the breakpoint feature, two alternatives can be employed. 
If the execution is to start at an address other than that specified by 
the program counter, the user enters the following type of command: 

G4400.4401<ENTER> 

-In this case, execution starts at location 4400H, with the breakpoint 
set at address 4401H. If the short test program used with the G com- 
mand is still in R/W memory, the computer executes the OOH, or no- 
operation command, and then reaches the breakpoint. Once the 
breakpoint has been reached, the monitor responds with the follow- 
ing display. The format of this display is covered in detail in the X 
command. 

P = 4401 S = 4300 X = 0000 Y=0000 N = 00 1 = 00 V = 3C00 
A = 00 B = 00 C = 00 D = 00 H = 00 L = 00 M = 000a F = 00 
A'OO B'OO COO D'OO H'OO L'OO M'OOOO F'OO 
4401: 3E 2F C3 00 44 

The program counter is now at address 4401H, which was the speci- 
fied breakpoint. It is assumed that at location 4401FI there is an exe- 
cutable instruction. That is, the breakpioint cannot exist within the 
address field of a call or jump instruction, nor can it be in a position 
that data would occupy. For example, you cannot execute the follow- 
ing sequence and expect to return to the monitor at the break. 

G4401.4402<ENTER> 

The data at 4402H is 2FH, and this is part of the load-accumulator 
instruction. There exists an instruction in the Z-80 code with a value 
of 2FH. However, when the load is executed the 2FH is considered 
data. When a breakpoint is requested, the instruction residing in 
that location is replaced with an instruction which causes a return 
to the monitor. Upon such a return, all breakpoints are cleared, so 
all of the original program steps are restored to their original state, 
as they were loaded prior to the use of any breakpoints. The only 
restriction placed on the breakpoint is that it must occupy the posi- 
tion of an instruction. 

More than one breakpoint can be specified. In fact, room is pro- 
vided in R/W storage for at least ten breakpoints. It is not envisioned 
that any user will require that many breakpoints in checking the 
operation of a program. For you to implement the multiple break- 
point feature, you simply place your breakpoints in sequential fash- 
ion using the period as a delimiter. For example, the following is 
the format: 
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G4400.440I .4403.4304<ENTER> 

With this command, all instructions at the three locations specified 
are replaced with a single-byte call to the monitor. Each instruction 
is saved in R/W memory along with its address. Execution begins at 
the specified address and stops at the first breakpoint encountered. 
All breakpoints are cleared, and the instruction formerly occupying 
that position is replaced. The breakpoints are entirely "transparent" 
to the user unless, of course, the user has lost control in his program 
because a crash has occurred. On rare occasions, this crash may not 
manifest itself to the user, and unexplained problems may appear. 
If the program counter does not agree with one of the set break- 
points, an improper termination has occurred. Also, if upon exami- 
nation of your program, some unexplained FFH codes appear in 
the program, a crash has occurred. The FFH is used by the monitor 
to indicate a breakpoint, and it remains if a break is not terminated 
properly. If the crash is not severe, the monitor will attempt to clear 
breakpoints upon the depressing of the reset button. 

Assuming a proper break is encountered and program execution 
is to continue at the address of the breakpoint, the user may restart 
the program by using the G followed immediately by the new break- 
points. 

G.4403.4404<ENTER> 

Notice the use of the period to indicate the breakpoint location im- 
mediately following the G. Notice also that upon termination from 
the program by means of a breakpoint the program counter agrees 
with one of the specified breakpoints. 

As indicated earlier, there are two methods of setting the break- 
points. The second method makes use of relative addressing. The 
addresses are relative to the program counter, and the arithmetic 
operations of plus ( + ) and minus (-) are used for breakpoint 
entry. The value following the operand is added to or subtracted 
from the program counter to estabhsh the breakpoint. The range 
of change ("bias") is OOOOH to FFFFH. Of course, the use of large 
relative jumps (biases) can result in what is called "wrap-around"; 
that is, once the value of the microprocessor's program counter ex- 
ceeds FFFFH, it wraps around to OOOOH without regard to the over- 
flow. An example of the use of the relative breakpoint feature is: 

G4401 . + 2. + 3. - 1 <ENTER> 

Here the breakpoints are the same as if the following were entered. 

G4401 .4403.4404.4400<ENTER> 

This feature makes breakpoint entry more convenient. Try it with 

62 



the example program. The first breakpoint returns control to the 
monitor with the program counter at 4403H. 

Since the register display occurs when a breakpoint is encoun- 
tered, let us examine in detail what the various registers represent. 

X COMMAND 

The X ( eXamine registers ) command is executed by pressing the 
X key after the prompt appears on the monitor or by making it part 
of the command buffer. In both cases, the register data displayed is 
that generated by the user during execution of the test program and 
not the data generated by use of the Z-80 internal registers by the 
monitor. The command; 

X<ENTER> 

produces the following display when the system is first powered. 

P=0000 S=4300 X = 0000 Y=0000 N = 00 1 = 00 V=3C00 

A = 00 B = 00 C = 00 D = 00 E = 00 H = 00 L = 00 M = D00O F = 00 

A'OO B'OO COO D'OO E'OO H'OO L'OO M'OOOO F'OO 

The first position on the first line is the program counter (P=). In 
the power-up initialization it is set to OOOOH. If a G is entered as a 
command, the monitor would cause execution of the program begin- 
ning at that location. The next register displayed is the user stack- 
pointer. The monitor initializes a reserved area for the user stack. 
This area is not used for any other purpose and extends from 42C0H 
to 42FFH. The stack is used in reverse order, and the first position 
filled with data is one less than that indicated by the stackpointer. 
The stackpointer always resides at one location above that location 
used to store the data on the stack. Therefore, data should be stored 
in the stack beginning at 42FFH. If the stack is not changed by using 
a stack modification instruction, then this register should be at 
4300H. The monitor stack resides at 42C0H and ends at 4280H. 

The third and fourth locations contain the information stored in 
index registers IX and lY. 

The next register is the N register, and it can take one of two 
values. If the value is OOH, then the maskable interrupt is not en- 
abled and no interrupts are possible when control is passed to the 
user program. If the register contains a OIH, then the interrupt is 
enabled when control passes to the user program. The I register is 
the interrupt vector register and has meaning only if the vectored 
interrupt mode (mode 2) is enabled. This register contains the up- 
per portion (the high-order byte) of the address of the vector. The 
lower address is available from data strobed on the data lines. This 
occurs when the interrupt acknowledge ( INTAK/ ) is issued by the 
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processor after an interrupt is requested. It is possible to cross page 
boundaries, although the technical manuals seem to imply that this 
is not the case. More detail of the use of the I register is given in the 
section dealing with the hardware modification that enables the full 
interrupt structure of the Z-80 microprocessor. 

The last entry in the first line is the location of stored video infor- 
mation. This is a monitor function and not a Z-80 function. The video 
information consists of 1024 bytes of data that make up the screen. 
Upon initialization, the video pointer resides at the same location 
as the beginning of the video screen memory block. The data located 
at these screen memory positions is stored in those same positions 
when control returns to the monitor. This data is then scrolled when 
the register information , is displayed. Any writing to addresses in 
memory that reference the upper video starting at 3C00H and end- 
ing at 3CBFH are scrolled and lost forever and cannot be recalled 
by the user. It is sometimes desirable to see alterations you wish to 
make to the screen display area of memory without having them 
scrolled upward when return is made to the monitor. If the V ad- 
dress is changed to point to 1024 locations of selected R/W memory, 
the data present in the video memory block at breakpoint time is 
transferred to the location starting at the address indicated. At any 
time, while under monitor control, this data can be viewed using 
the T (Transfer) command (the changing of the pointer may be 
accomplished with the X command as will be shown). Therefore, 
any data written to the screen while in the user program is readily 
observable. It should also be noted that before execution of your 
program the screen data present at the pointer is transferred back 
to the screen. 

The next two lines of the display register command contain the 
data present in all of the Z-80 registers. All of the registers internal 
to the Z-80 processor are loaded with the displayed data (in this 
case 00). This particular pattern is present at power-up as part of 
the initialization. A return through a proper breakpoint saves the 
status of these registers at the time of the break. They are displayed 
from left to right starting with the A (accumulator) register, the 
B and C registers, the D and E registers, and the H and L registers. 
The next position is the H and L comlained to form M (memory 
pointer) (added because of the many references made by this 
pointer). The next position is the F or flag register. This register 
shows the flags that are set. 

SZXHX/NC 

The above F register display is interpreted as sign, zero, not used, 
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half carry, not used, parity/ overflow, subtract, and carry. If no al- 
phabetic representation appears, it implies that no flags are set. 

The last two lines are of the same format. The difference is that 
the first represents the working registers and the second represents 
the mirror or prime registers. The use of these registers is primarily 
for servicing interrupts quickly, but they come in handy for many 
operations that require the use of a register without destroying the 
previous value in that register. All the registers internal to the Z-80 
processor are loaded vwth the data displayed, and a return to the 
monitor through a proper breakpoint saves the status of the Z-80 
registers at the time of the break. 

X COMMAND (MODIFY) 

The X command may be used to modify the contents of any of the 
displayed registers. To use this feature, you enter the new data pre- 
ceding the <ENTER>. For example, to change the video storage 
from 3C00H to 4C00H, perform the following: 

XV4C00H<ENTER> 

The monitor responds, 

V=3C00 V=4C00 

The change remains in efl^ect until the register is altered with the X 
command, a power reset occurs, or a GO command is executed. To 
change any of the other registers the format is the same. Just follow 
the X with the register name as displayed. The registers are as fol- 
lows: P (Program counter), S (Stack pointer), X (IX Register), Y 
(lY Register), N (Interrupt enable upon execution— 00 for no and 
01 for yes), I (Interrupt high vector address in the Z-80 micropro- 
cessor), V (Video storage in RAM), A, B, C, D, E, H, L (the work- 
ing registers), M (pointer formed by HL), and A', B', C, D', E', 
H', L', M' ( mii-ror registers ) . 
Note that the command, 

XF' FF<ENTER> 

produces the display: 

F'OO F'FF SZXHX/NC 

All of the registers are alterable with Z-80 object code. However, 
once the video storage address is changed, only the XV, GO, or 
power-on clear operations can reset this address. Once located to a 
valid R/W location, the execution of a G command takes the data 
at that location and transfers it to the screen RAM prior to execution. 
You may wonder where the "garbage" comes from when you execute 
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this command. Returning from a break takes the data in the screen 
area and saves it at the allocated storage aiea. This is done so that 
user programs that require the video as the output device can be 
developed with greater ease. 

A method exists for clearing the screen prior to execution. A sec- 
ond command for execution with breakpoints is included in the 
monitor command set. This is the E command and is the topic of 
the next section. 

E COMMAND 

The E ( Execute ) command is identical to the G command, except 
that the current screen information is used at the start of execution. 
If in the user program any output to memory 3C00H to 3FFFH oc- 
curs, the new data replaces the data formerly in the addressed posi- 
tion. This command, in conjunction with the C, T (descriptions of 
these follow ) , and XV commands, may be used for scroll protection. 
When scrolling occurs, the top line of the crt display is erased, and 
the lines below are all shifted upward by a single line. Essentially, 
this is a line-feed when the carriage is returned on a typewriter. The 
FROLIC monitor allows you to protect the display area so that this 
information is not lost. This is done with the XV command as de- 
scribed. As with the G command, return from execution relocates 
the screen data to the storage area indicated by the V address. It is 
the user's responsibility to keep a record of the memoiy space to 
avoid conflicts. The format of this command is: 

E4500<ENTER> 

Like the G command, execution begins at location 4500H. The dif- 
ference is that the screen data is not replaced with the data that was 
in the reserved memory space. Breakpoints may be included as 
shown: 

E4500. + 1 .451 0<ENTER> 

Breakpoints set here are 4501H and 4510H. To clear the screen area 
prior to execution, use the C command. 

C COMMAND 

The C (Clear) command clears the screen. If in your program 
development the screen is to be used as an output device, it may 
be desired to have the ASCII "blank" character fill these RAM loca- 
tions. Execution of the C command clears the screen. Utilization is 
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the same as other commands, except that no address or data fields 
are required. For example: 

C<ENTER> 

produces in the lower left corner the prompt 

FROLIC: 

The rest of the screen is clear. It should be noted that the sign-on 
with the prompt ":" is the result of return to the execution of the 
command mode. The CLEAR key is identical in function to the C 
command. Depressing this key produces a C in the command buffer. 
In both cases, the clear is a two-step operation that makes accidental 
use of this command more difficult. To view the data, the T com- 
mand is used. With the T command, the prompt does not appear. 

T COMMAND 

The T (Transfer) command transfers the stored screen informa- 
tion located at the address specified by the V register ( which is not 
a Z-80 register). For this command to be effective, the screen storage 
must be changed prior to using this command. This is done with the 
XV command as previously described. Therefore, returns from the 
user program caused by execution of the E, G, or Z (hardware option 
to be described) commands result in the information stored in the 
crt R/W memory being moved to the allocated area. That informa- 
tion may be recalled for inspection while in the command mode by 
using the T command. The result is scroll protection, because after 
a breakpoint is encountered while the microprocessor is executing 
object code, execution ceases, and the screen data is stored begin- 
ning at the location stored in the V register. This data is restored to 
the screen using the T command, just as it was when execution was 
interrupted. In this case, the sign-on message does not appear in 
the crt field. However, the cursor may be present ( a function of the 
position of the G or E command in sequential executions ) . 

Change the video pointer to 4C00H, and execute a G with a 
breakpoint. Alter the data on the screen with a series of <EN- 
TERS>s. Now, to view the data stored in the reserved memory space 
( as determined by the V field at the time the G reached its break- 
point), enter, 

T<ENTER> 

The stored data now replaces the data on the screen. Note the 
change in the screen. If the executed program had cleared the screen 
(at this point, it does not matter how this was accomplished) the 
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"FROLIC:" would not appear on the crt screen. Although not ap- 
parent, the monitor is waiting to accept a new command. Any key 
entry will be displayed with the cursor mark reappearing after the 
entry. Continuation of execution using the G ( or Z ) command auto- 
matically returns the stored data to the screen just prior to execu- 
tion. 

Caution is required for the use of this command in a command 
sequence, for its return is always to the command entry point of the 
monitor. It can only be the terminal command of a command se- 
quence, for any command that exists after it is not executed by the 
monitor. This is the only command that functions in this manner. 
Grouping of commands for execution is covered in later sections. 

A COMMAND 

The A (display [AJSCII) command is for American Standard 
Code for Information Interchange display. This means that if the 
character in memory has an ASCII equivalent or graphic represen- 
tation (Radio Shack format), it can be displayed in a single position 
representative of the hexadecimal value. Even though the graphic 
character is not part of the ASCII code, the pattern of the graphic 
byte is written to the screen area. In fact, the only pattern that is not 
displayed is the 08H (backspace or rubout). If this code is in the 
field specified in the command, the byte prior to 08H is also not dis- 
played. The crt driver program automatically removes data prior to 
the rubout. Since the A command is primarily intended for the dis- 
play of ASCII-based text information, there is no correction for the 
rubout due to the limited EPROM space. The format of this com- 
mand is the same as that of the D command. Two options are pos- 
sible: the block format and the through format. A typical command 
follows: 

A3C00 100<ENTER> 

This command results in the display of the lOOH locations of the 
video screen area beginning at 3C00H. These lines consist of an ad- 
dress followed by 32 decimal characters. The same display of ASCII 
characters can occur by entering the alternate format, 



A3C0OT3CFF<ENTER> 



F COMMAND 



The F (Find) command allows the user to find a single byte of 
data within the range specified by the address fields. Three fields 
are required in this format: the starting location, the ending location 
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or number of bytes to search, and the byte desired to be found. For 
example, 



F000OT4FFFH F3<ENTER> 

or 

F0000 5000 F3<ENTER> 



searchs memory for all occurrences of F3H, starting at OOOOH and 
ending at 4FFFH. Each address at which the byte is found is dis- 
played in the following manner: 



0014: F3 
OOXX: F3 
OOXX: F3 



Q COMMAND 

The Q (Quest) command is similar to the F command with this 
important difference: a two-byte search is made. The format is the 
same as that of the F command, but the data is interpreted as an 
address, so if the following is entered into the buffer: 

Q0040T07FF 4000<ENTER> 

or 

Q0040 780 4000H<ENTER> 

the result is a search for the low-order byte OOH followed in memory 
by the high-order byte 40H, made over the range specified. The re- 
sult should produce the following display: 

0080: 00 40 
0345: 00 40 

This format of low-followed-by-high is a function of address data 
for the microprocessor. That format was preserved in the implemen- 
tation of this command. 



@ COMMAND 

The @ ( fill @ ) command allows the user to fill memory with a 
constant. Two more ways to clear the screen follow: 

@3C00T3FFF 20<ENTER> 

or 

@3C00 0400 80<ENTER> 

By necessity, this is a three-field command. In this case, the third 
field is the data to be deposited in memory over the range given. In 
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the first example, the ASCII blank (20H) is deposited. In the sec- 
ond example, the graphic blank ( 80H ) is deposited. They both per- 
form the same function. If more arguments are typed in than can be 
used by the command, the monitor accepts only that required, and 
it ignores the extra fields. The space is used as the delimiter for the 
last argument. This command can be used for presetting memory 
space to a reference byte such as 00 or FF. 

You must be very careful when using the fill command. If a block- 
type format is used, it is all too easy to wipe out important data such 
as the user program, saved video information, or other critical data. 

H COMMAND 

The H ( Hexadecimal arithmetic ) command is used for hexadeci- 
mal arithmetic. The format contains two fields. The display first 
shows the result of the second argument added to the first, and then 
the second argument subtracted from the first. This command is use- 
ful for computing offsets for loading from cassette tape. An example 
of its use: 

H9000 3000<ENTER> 

results in the following display: 

€000:6000 

N COMMAND 

The N ( iNput ) command is used to read the status of any input 
ports that may be attached to the TRS-80. The format also allows 
reading a range of inputs by specifying the range using the "T" as 
the delimiter or by specifying the number using the <SPACE> as 
the delimiter. To show an example of the format, port FF is used. 
As you know, for Model I and III systems, port FF is available with 
bit 7 used for data from a cassette. Also, if the system is a Model I, 
bit 6 is used to indicate activation of the large graphic mode. For a 
Model III system, port EC, bit 2 serves this same function. Unless 
other ports have been decoded (as is the case with a Model III 
system ) , reference to any port other than FFH will result in an FFH 
display, since the dataform of unused inputs is detected as all ones. 
An example of a single port input with a Model I is: 

NFF 1<ENTER> 

The display on the crt screen is 

FF: 7F 
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or 

FF: 3F 



depending upon the activation state of the large-graphic feature. 
On a Model III system the display is 



FF: 40 



The N command may respond to a range of inputs by default if 
no range is specified. The default range is 40H, as with the D and A 
commands. If one of the following formats is used: 

N0OT05<ENTER> 

or 

NOO 5<ENTER> 

the output is as follows : 

00:FF 01:FF 02:FF 03:FF 04:FF 

COMMAND 

The O ( Output ) command is used to output data to a port speci- 
fied in the format. Of course, the hardware for the port must exist 
in order for the command to have meaning. The Model I and III 
TRS-80s have output ports already available as mentioned in an 
earlier chapter. As an illustration of the use of the O command, the 
large-graphic feature is enabled through a port access. In a Model I 
system, a OSH written to port FF enables this feature. In a Model III, 
a 04H to port EC enables the graphic. The following example shows 
how to enable the large-graphic display in a Model I system. 

OFF 08<ENTER> 

or, for the Model III 

OEC 04<ENTER> 

The screen now shows every other location ( the even locations ) . In a 
Model I system, the keyboard scan checks for large-graphic enable 
and compensates by inserting the additional increment in the mem- 
ory pointer. This is true only for the Model I system because of the 
limited EPROM memory that required more space in the Model III 
computer. Increased visibility due to the larger size is an apparent 
advantage through the use of this command on the Model I. In 
either case, previously written data or data transferred using any 
move-memory tyiDe of command displays only the even locations of 
the screen R/VV memory. 
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The graphic feature is reset through output of OOH to port FF 
for the Model I, or to port EC for Model III. Any command involv- 
ing cassette operations, any command with a syntax error in its for- 
mat, or any command that causes a power-on clear resets the large- 
graphic feature. 

A second example using port FF on the Model I or port EC on 
the Model III activates the cassette motor. Using the O command, 
execute 

OFF 04<ENTER> (Model 1) 

or 

OEC 02<ENTER> (Model III) 

The cassette motor is now active. By using the O command, the 
motor can be turned off by resetting the appropriate bit. 

M COMMAND 

The M (Move) command is used for block moves of memory 
from one location to another. Three fields are required to execute 
this command. The format for the first two fields is the same as for 
the A and D commands. That is, the format consists of a beginning 
address, a space, and a block length, or the beginning address 
through the ending address. The third argument is the beginning 
address of the destination block. Be careful not to destroy data by 
improper use of this command. The following example shows both 
ways of performing block moves: 

M6000T601F 7000<ENTER> 

or 

M6000 20 7000<ENTER> 

In this example, the 20H bytes located starting at 6000H are moved 
to 7000H. In many cases duplicating your program in memory saves 
re-entry of the object code if a system crash occurs. Of course, there 
are malfunctions that destroy everything in the memory space, in 
which case nothing is gained by making a backup copy of your pro- 
gram in RAM. A long program could be saved on tape as an alterna- 
tive option. 

V COMMAND 

The V command compares and verifies one block of data against 
another. It is automatically called if a block transfer is used. This 
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instantly informs the operator if an attempt is made to move to read- 
only memory. The format for the V command is the same as that of 
the M command. Three fields are required: a start address, an end 
address or block length, and the location at which the verification 
is to begin. An example is: 



V6000T601F 7000<ENTER> 

or 

V6000 20 7000<ENTER> 



Any difference that exists betvi^een the blocks is printed on the 
listing device. A display occurs only if the two locations differ. For 
example: 

6013: 67 7013: D3 

W COMMAND 

This command and the next command concern themselves with 
the writing of programs on cassette tape and the reading of those 
tapes back into the system. The format used in the transcription of 
these tapes is the same as that used by the TRS-80 Level II system. 
The speed is 500 b/sec. In producing a tape, a name may be as- 
signed. Up to six ASCII identifiers are possible. 

The W ( Write ) command is used to produce a tape in the TRS-80 
format. To execute the command it is entered as follows; 

W4400 100 4400 NAME<ENTER> 

or, 

W4400T44FF 4400 NAME<ENTER> 

The use of the name is optional, but an execution address must be 
given, or improper operation results. The space delimiter precedes 
the name to indicate that a name is to be written. If not present, the 
space allocated for a name on the tape is filled with 20H, the ASCII 
representation of a blank character. The execution address does not 
have to be the same as the starting location. However, the execution 
address is placed in the program counter register when the tape is 
read using the R command. To terminate the W command for any 
reason, simply depress the <SHIFT> key. 

R COMMAND 

The reading of a cassette tape occurs by using the R (Read) 
command. This command has an address field associated with it that 
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is optional. If an address is entered, the data is interpreted as an 
offset and is added to tlie address that is read from the tape at the 
beginning of each block. This allows the tape to be loaded in any 
available R/W memory. It is particularly useful for the loading of 
data to be used for the programming of EPROMs. In these cases, the 
execution address is often in locations other than that available as 
R/W memory in the TRS-80 system. In computing offset, the H com- 
mand is used. 

The format of the R command is, 

R<ENTER> (no offset) 

or, 

R4200<ENTER>. 

In the latter case, 4200H is added to each address during the reading 
sequence. If the tape is being read properly, the name appears after 
proper detection of the sync marker. No name results in a displace- 
ment of the cursor by six spaces. If no error occurs during the read, 
the execution address appears after the name ( if present ) , and con- 
trol returns to the monitor. The program counter register is also 
loaded with the starting address. As a consequence, execution of the 
loaded program can proceed by entering a G, E, or Z (optional 
hardware reauired) command without the address in the format. 
An error during the R command results in a buffer display with a 
'?" in the location of the R command. This error results from im- 
proper adjustment of the level control on the recorder or a bad 
recording. The error itself is usually an improper checksum. Also, 
there are cases in which the sync mark cannot be detected. Depress- 
ing the <SHIFT> at any time terminates the R command. 

L, P, AND U COMMANDS 

The next three commands require hardware modifications to the 
TRS-80 system. The L command allows hard copy, and more infor- 
mation on hard-copy devices is given in Chapter 3 along with soft- 
ware support. The P command allows EPROMs to be programmed. 
Hardware and software to support this feature are given in Chapter 
4. The last command in this section is the U command. It provides 
an access to system R/W memory and return to the monitor for user 
defined commands. A fourth command (Z) is available to allow for 
a single-step function; the explanation and hardware requirements 
are given at the end of this chapter. 
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L Command 

The L (List) command is used for listing on a hard-copy device. 
It is assumed that a hard-copy device is available and the appropri- 
ate software support is loaded into the system. The L command acts 
as a switch and is activated any time the L command is executed in 
a command string. The first time the L is encountered, it turns on 
the hard-copy feature. The next time the L is executed, the listing 
on the hard-copy device stops. This command requires no address 
fields. For example, 

L<ENTER> 

is all that is required to activate the hard-copy device. The appropri- 
ate firmware ( software plus hardware ) must be available to support 
the option. Output may be through the cassette terminal and is avail- 
able as a 20-mA current loop or as RS-232C voltage levels. A possible 
hardware interface is shown in Chapter 3. If this option is not used, 
this command may function as a user specified command. The user 
specified program should start at 4018H. A three-byte jump may be 
inserted to cause execution of the driver program or the user speci- 
fied program. The rules for using this jump and return from it are 
covered in the U command and in the software sections dealing with 
the printer. 

P Command 

The P command is used to program EPROMs. Chapter 4 deals 
with the hardware required to provide this feature. This command, 
along with the U and L commands, does not have a resident pro- 
gram in the monitor. However, upon power-up initialization, returns 
(RET a C9H) are inserted into locations which normally would 
provide the monitor access to a user program. If the options are to 
be used, a jump ( C3H ) to the address of the user supplied routine 
must replace the appropriate C9H in the R/W memory referenced 
by the command. The address of the jump for EPROM program- 
ming is 401BH through 401DH. Greater flexibility in the program- 
ming of EPROMs is thus provided. For example, the programs used 
for programming 2716 EPROMs, 2708 EPROMs, or 8755 EPROMs 
can be entered as presented in Chapter 4 ( Chapter 4 is devoted to 
the PROM programmer). The addresses of execution are loaded 
into the referenced vector when the tape containing the EPROM 
programming code is loaded into memory. The reset does not clear 
these addresses. These locations are cleared through one of the fol- 
lowing operations: a power-on clear when the system is turned on, 
or the execution of a GOOOO. The latter assumes that the monitor 
resides at OOOOH. 
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To use this command, the user must first load the EPROM pro- 
gram routine. This can occur at any time prior to the execution of 
the command. Depressing the P followed by the <ENTER> trans- 
fers conti-ol to the EPROM programming routine. Depending upon 
the software used to drive the programmer, fields may also be in- 
cluded in the entry when this command is executed. The software 
in Chapter 4 does not pass information to the programmer using 
the address fields, 

U Command 

The U (User) command is identical in operation to the P com- 
mand, but in this case a user written program resides at the address 
specified. This program must be loaded, of course, previous to its 
execution, and RAM locations 401EH to 4020H must contain a jump 
instruction (C3H) followed by the address at which the user pro- 
gram resides. 

Another consideration that must be included in the object code is 
a correction in the buffer pointer that resides in the lY register. 
Commands without fields do not advance the buffer pointer. Al- 
though the command you insert executes (if correctly written), 
upon return the monitor expects a comma in the buffer. Since the 
buffer is not advanced, the unexpected U causes the buffer to be dis- 
played with the "?" replacing the U. This may produce strange be- 
havior if a BS command (to be covered in the next section) is used 
at the end of a command sequence. 

Two methods to correct the pointer may be employed. The first 
uses any subprogram in the monitor that accesses the buffer and 
therefore increments the pointer. For example in the listings in Ap- 
pendixes D and E, the programs labeled GHL, G2N, G3N, and GET 
all advance the buffer pointer. Remember, you are not leaving the 
monitor with the register states changed as happens in the G, E, 
and Z commands. Using the U command is part of the monitor code, 
and, therefore, any change to a register is transparent to you and not 
observable with the X command. The other method is to increment 
the data in the lY register by using the instruction INC lY (FD 23) 
in your driver program. Here is an example of a program that pro- 
vides a short time delay between commands. The code is loaded 
starting at address 4300H. 



4300 FD23 


DELAY 


INC lY 


ADJUST POINTER 


4302 210000 




LD HL.OOOOH 


INITIALIZE COUNT 


4305 25 


DEL 


DEC H 


DECREMENT HIGH 


4306 C20543 




JP NZ,DEL 


DO UNTIL ZERO 


4309 2D 




DEC L 


NOW DECREMENT LOW 


430A C20543 




JP NZ.DEL 


DO UNTIL ZERO 


430D C9 




RET 


BACK TO MONITOR 
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To use this program, load the code using the I command. At the 
same time change the return at 401EH to C3H and insert the OOH 
and 43H in the next two locations. Keep in mind the low-high for- 
mat. Transfer is now possible from the monitor to the delay program. 
The following command sequence accomplishes both requirements: 

14300 FD 23 21 00 00 25 C2 04 42 2D C2 04 42 C9 401 E/ C3 00 
43<ENTER> 

The U command is ready for testing. The jump to this command does 
not change unless a GO or power-on clear occurs. To use the U com- 
mand enter, 

U<ENTER> 

Notice the short delay before the sign-on appears on the monitor 
screen. Save this program, for it is used in the demonstration of the 
commands B and BS. 

It was already indicated that all unused commands in the com- 
mand table are available for use. The buffer pointer must be adjusted 
if no reference to the buffer is made. Although there is no link pro- 
vided in R/W memory for these, as is the case for the L, P, and U 
commands, the use of these commands may be acquired by repro- 
gramming the EPROM that contains the monitor program. Chapter 
4 shows how this is possible. 

BUFFER 

In the description of the commands presented so far, reference 
has often been made to the buffer or to the buffer string. The monitor 
presented in this chapter is in fact an interpreter, and all of the com- 
mands described may be entered as a series of commands forming a 
command string. You may exercise this option by using the comma 
"," in place of the <ENTER>. The latter occurs only once, and that 
is at the end of the sequence. While entering commands in the buffer, 
the rubout or backarrow allows removing improper entries. If the 
command sequence is extremely large, the use of the <BREAK> 
allows exit without execution. There are 256 decimal locations re- 
served for the buffer, so an upper limit to the number of commands 
is imposed. An example demonstrating the use of the command 
string follows. This command sequence enters object code in mem- 
ory, displays the code, clears the crt screen, relocates the saved video 
information for recall, executes the program using the just cleared 
screen, returns at the selected breakpoint, and transfers the video 
information back to the screen as it was upon reaching the break- 
point. 
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14800 3E 41 2A 00 3D,D4800 5,C,XV4CO0,E4800.+5,T<ENTER> s 

Data is entered directly from the command string. The execution of 
this short program results in the 41H or "A" being written at location 
3D00H, which is in the first position of the fourth line. This does not | 

occur until the E4800 is executed. When the <ENTER> is de- ' 

pressed, the string is executed as follows: First the data is entered 
with the I command, the data is displayed with the D command, and 
then the screen is cleared with the C command. The XV4C00 pro- 
vides a place in RAM to save the data on the screen upon reaching , 
the breakpoint. The actual execution of the program is accomplished 
with the E4800. With the T command the result is viewed: a blank 
screen and the "A" as described. This termination of the command 
string with the "T" is the only vaHd position of the T command. It 
can be used alone for transfer after a command string has been 
executed. 

It was indicated earher that you could enter data interactively 
from the keyboard through the use of S4800 (in Ueu of 14800) and 
by omitting the data sequence. However, keep the rest of the entry 
as shown in the example. The data for executing the short program 
may now be entered through the keyboard with the <ENTER> 
now used to deposit the data in memory. Upon completion, depress | 

<ENTER> twice. This causes execution of the remaining string as 
in the first example. 

If the delay program ( given in the U command section ) is resident 
in the monitor, this second example may be more convincing as an 
illustration. In the command sequence, the delay program is con- ^i 

sidered the program developed, and it is tested as follows: 

X,G4200. + 2,U,G. + 3,U,G.4206,U,G.4209,U,G.420A,U,G.420D<ENTER> 

The delay is short, so pay attention to the H and L registers. Break- 
points are placed after critical instructions. This demonstration se- 
quence illustrates the use of the monitor as a development tool. The 
X command at the start of the sequence displays the status of all the 
registers at the start of execution, and therefore, when G4200 is exe- 
cuted, the data in these registers is transferred into the Z-80 registers. 
At the first break, after the INC lY instruction, the automatic display 
of the internal registers shows that the only register altered is the Y 
register, and its value has been incremented by one. The next break- I 

point shows the H and L registers initialized to OOOOH. The follow- 
ing breakpoint occurs after the H register is decremented from OOH 
to FFH. This is the first instruction to alter the flag register, and the 
Z flag is absent from the flag display. (In the Z-80 instruction set, 
double register increments and decrements do not affect the status Ji 

of the flags. ) The break at 4209H occurs after the H register is dec- 
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remented 256 times, and the zero flag is observable. The last break 
is after 65,536 decrements. The H and L registers are now both zero, 
and the zero flag is zero. The last command in the sequence is exe- 
cuted, and control is passed back to the monitor for the next com- 
mand instruction. 

A third example of the use of the command sequence further dem- 
onstrates its power. In this example, we demonstrate the usefulness 
of the monitor as a teaching device to aid in understanding the in- 
struction set of the Z-80 processor. Assume for the moment you wish 
to identify the difference between the compare and subtract instruc- 
tions. The data in the accumulator is less than the data it is to be 
compared with, which resides in the B register. Enter the following 
command sequence: 

14300 B8 90,XF00,XA85,XB9E,H85 9E.G4300. + 1 ,XA85,XF00. 
G. + 1<ENTER> 

The object codes for the two instructions ( compare A register with 
B register [B8H] and subtract B register from A register [90H] ) are 
entered at 4300H and 4301H. The flag register is cleared of flags 
(XFOO), and the A and B registers are initialized. The H command 
is used to see the sum and difference of 85H and 9EH, and the com- 
pare is executed. Since A is less than B, the carry is set. This is a 
convention opposite to what you would expect in twos (or tens) 
complement arithmetic, but more famiHar to the process you use in 
decimal subtraction. The compare is accompHshed with a subtract. 
This operation does not use the status of the carry (borrow), similar 
to other logic instructions. Furthermore, the accumulator is not al- 
tered. Since the two numbers are different, the zero flag is not set. 
Also the second number is greater than that in the accumulator. 
Therefore, a carry (borrow) is generated. In subtract operations, 
the meaning of the carry flag is the same as a borrow. Since this op- 
eration was a subtract, the N flag is set. The other flag set is the H 
flag, and it would have meaning if the original entries were binaiy 
coded decimal. The overflow flag is not set, since the number is rep- 
resentative of the subtraction within the range of —128 to -1-127. In 
this case a —98 (9EH in twos complement) was subtracted from a 
-123 (85H), leaving a -25 (E7H). The subtract instruction that 
follows shows this to be true. It was not necessary to initialize the 
accumulator with the 85H since this data was not destroyed by the 
compare instruction. After the subtract is executed, you will notice 
that the accumulator now contains E7H (the H command shows the 
difference to be FFE7H ) , and the flags are the same as for the pre- 
vious compare. 

The addition of the command sequence buffer to the monitor is 
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its most powerful attribute, and, as a result, two additional com- 
mands are available. 

BS AND B COMMANDS 

The BS (Buffer Save) command saves the command sequence in 
a reserved area for repeated execution. You simply enter a BS as 
part of the string and the buffer is saved during execution of the 
sequence. To execute the saved buffer, a B (execute Buffer) com- 
mand, transfers control to the buffer, and execution of the buffer 
begins immediately. The B should terminate the sequence, since any 
instruction that follows the B cannot be executed. The reason for 
this is that after the transfer execution begins with the first command 
in the buffer. It is quite easy for you to enter into endless loops with 
this command. For instance, the following loops upon itself, saving 
itself and executing itself endlessly. 

BS,B<ENTER> 

To regain control of the command buffer, depress the reset switch. 
The use for this command is unhmited. Although there can only be 
one saved buffer sequence resident in the monitor, nothing jjrevents 
the user from saving this sequence with the move command ( M ) , or 
storing the buffer on cassette tape. To aid you, you should know that 
the buffer is located from 4180H to 427FH. The memory after these 
addresses, up to 4300H, is used for stack storage. One can use the 
move command to change the saved buffer to regain a desirable se- 
quence of commands, then execute the B command. Testing hard- 
ware involving input, output, or a combination is possible with the 
command. For example, to check for proper address decoding in 
your interface design, you could execute the sequence: 

BS,N80,O28,B<ENTER> 

This results in the "strobing" of the device address signals for ports 
80H and 28H along with IN/ and OUT/ signals. To exit from this 
loop, depress the <BREAK> key. 

A second example of this command shows entry of complex break- 
points. The program counter must be initialized with the XP, G, or 
E commands. Entering the sequence 

BS,G.4303.4304.4309.43E2,B<ENTER> 

results in register displays in the order the breakpoints were reached. 
Holding of the space bar allows examination of the data in the reg- 
isters. 

Continuous single-stepping in read-only memory in addition to 
R/W memory is possible if the single-step hardware has been imple- 
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mented. The description of this next command completes the 
chapter. 

Z COMMAND (SINGLE-STEP) 

The Z (single-step) command requires a hardware modification 
to implement. It is a most attractive addition to the command set, 
for this is one way to execute instructions in ROM. Coupled with 
the BS and B commands, the Z command aids significantly in soft- 
ware development. The execution address, which loads the program 
counter, can be initialized with the same convention used in the G 
or E commands. If the hardware is not present, a breakpoint should 
be included, and the command will function. However, one obvious 
and significant difference occurs if you do this: the program counter 
decrements upon return, because the instruction at the breakpoint 
address is never executed when using the breakpoint feature. In- 
stead, the single byte call of the RESTART instruction replaces the 
normal instruction residing at that address. However, the Z com- 
mand, or single-step, in contrast, executes the instruction located at 
the position of the current program counter. The instruction may be 
any length and any type. Jumps or calls, single or two byte loads, 
and even those four byte Z-80 codes are all executed. The instruc- 
tions may exist in ROM or in RAM. The format for this command is 

Z<ENTER> 

or 

Z4800<ENTER> 

However, there is one feature you must be aware of when using 
the single-step option. If the instruction to be executed is a disable 
interrupt, return to the monitor will not occur since the hardware 
uses the interrupt to accomplish this end. (If the execution is in R/W 
memory, a breakpoint may be appended to the Z command, and 
return will occur at this breakpoint. If this does occur, the program 
counter as displayed by the P register will be one greater than the 
breakpoint. An adjustment must be made to correct this register to 
continue with proper execution.) 

The mode of interrupt should remain mode 1. The other two 
modes, and 2, may work. In mode 0, the interrupting device is ex- 
pected to place any instruction on the data lines during the INTAK/ 
time, and the microprocessor executes it. By default, in the Model I 
an FFH is strobed on the data lines, unless you have altered the sys- 
tem with additional hardware to strobe these data lines. An FFH 
instruction is an RST 38H, the same as used for the breakpoints. Thus, 
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the return back to the monitor will be to the register save routines. 
This is not the case with a Model III; if the mode of interrupt was 

changed to mode under a user software routine, then hardware 
must be supplied to accomplish the strobing of an FFH onto the 
data lines. In interrupt mode 1, the data lines need not be strobed, 
and the microprocessor responds automatically to the interrupt by 
executing a restart to location 0038H. This is the mode of interrupt 
initiahzed by the monitor during power-up. 

You can use mode 2, but the LSB of an address and not a restart 
is strobed onto the data lines during the INTAK/ time. The MSB of 
the address is obtained from the (I) vector. (Refer to the TRS-80 
technical manual for more detail.) This address must point to a 
location that will cause execution to take place at the register save 
routines in the monitor program. Hardware must be supplied, and 
in addition if the unit is a Model I, the interrupt alteration must be 
made. (Refer to Chapter 1.) This last method for single-stepping 
should be avoided unless absolutely necessary for your program de- 
velopment, at which point you must design the hardware to support 
the use of this mode of interrupt. 

An example of the usefulness of the Z command is shown by using 
the following sequence: 

BS,Z,B<ENTER> 

The program counter should be initialized to the starting address 
external to this string, and the stackpointer should not conflict with 
the monitor stack. The crt will display the register status as each in- 
struction is executed. If a hard-copy device is availabfe and the driver 
program loaded, the addition of the L command to the sequence 
will provide a hard-copy output. 

BS,L,Z,L,B<ENTER> 

The L could also be activated external to the command. The listing 
device will trace the execution of each step in the program until you 
cease its operation using the <BREAK> key. 

The hardware modification for the single-step addition is shown 
in Fig. 2-1. These modifications can be made internally by altering 
the CPU socket or externally by using the system bus signals avail- 
able at the edge-card connector. Two design possibilities exist, as 
shown in Fig. 2-1. The single-step hardware must use a port to acti- 
vate the shift register. The port chosen for this application is port 
OOH. A slight difference exists in the designs between the two TRS- 
80 models. For the Model I, the instruction fetch cycle signal (Ml/ ) 
is not available at the edge-card connector. Instead of using the fetch 
cycle to advance the low logic level through the shift register, the 
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Fig. 2-1. Single-step circuit diagram for TRS-80 Model I and Model III. 
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RD/ signal is used for this function. Because there are more memory 
references, a different output from the shift register is required. The 
tapped positions for these control signals are referenced in the sche- 
matic. The complete design is shown in Fig. 2-1. 

The theory of operation of this circuit is to use a port write to 
activate a low level in a data latch, then shift this low through a shift 
register. The data latch is cleared after the first shift using output 
Qa of the 74LS164. If single-step is required, the port write is to port 
OOH (the only time this port is accessed by the monitor). The exe- 
cution of the Z command sets a flag, and if true when tested the EI 
and OUT ( OOH ) A instructions are executed. If the flag is not true, 
these instructions are bypassed. For single-step to occur, the low 
bit from the latch must be shifted through the shift register. For each 
Ml/ or RD/, this low bit is shifted. You simply count the number of 
memory references (Ml/ or RD/ ) and tap the shift register at that 
point in order to produce the single-step interrupt. A second data 
latch is used to hold the interrupt request ( INT/ ) line low until it | 

is acknowledged by the CPU ( INTAK/ ) , which then resets the data 
latch and returns the INT/ to the high logic state. In the monitor as 
written, there is one instruction with three memory references be- 
fore the single-step interrupt can occur. Depending upon the 
TRS-80 model used, the instruction fetch (Ml/ for the Model III), 
or the memory reference ( RD/ for the Model I ) produces an inter- 
rupt at the appropriate time resulting in the execution of a single 
instruction. Of course, if there is a possibility of interrupts from 
other sources that may have been implemented on the system, a 
break may occur somewhere between the JP (JUMP) instruction 
and the last memory reference. If this is a possibility, examine the 
program counter upon return. This register is your indication of what 
has occurred. 

Key elements in the hardware design are the port decode and shift 
activization. The 1 of 8 decode (74LS138) was chosen to give flexi- 
bility in port choice, but modifications in the software must reflect ^ 
any port change. The shift register is constantly shifting a high > 
through it each time an instruction fetch or memory reference is 
made. The 74LS164 shifts on the positive edge of either of these two 
signals. The moment execution reaches the user's program, a latch 
is set to activate the interrupt line. This latch is cleared with the in- 
terrupt acknowledge signal. The interrupt signal from the shift reg- 
ister has provision to be gated with an external interrupt to allow 
for greater flexibility in system design. 
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CHAPTER 3 



Hard Copy From 
the Wonitor 



When editing programs, it is often useful to have a listing of the 
instruction codes on j)aper. One of the cheaper sources for hard copy- 
is the teletypewriter. Though slow, it has a proven record of reliabil- 
ity. A software option is included in this chapter: a teletypewriter 
driver routine. To use this software option, a hardware interface is 
required. A circuit is provided that allows two-way communication 
with a serial device through the cassette DIN plug. If only the serial 
printing option is required, then the hardware that converts the tele- 
typewriter data transmission signals to TTL levels (suitable for in- 
put to the TRS-80 using the cassette plug) can be omitted. To acti- 
vate the teletypewriter list option, a program must be entered into 
memory. The program and the loading steps are given later in this 
chapter. The L command is used to activate the printing device, as 
described in Chapter 2. 

The program given drives a serial device, which may be com- 
patible with either RS-232C voltage levels or 20-milliampere current 
loops. Implementing the circuit is straightforward, since the control 
of the circuit is determined by the software. 

The hardware schematics for serial input/ output are showTi in 
Figs. 3-1, 3-2, and 3-3. For serial transmission to a printer, a com- 
parator converts the audio cassette signals to bipolar voltage levels 
that are compatible with the RS-232C interfaces in most serial print- 
ers. Since a few printers require a 20-milliampere current drive, 
additional hardware is used to generate the necessary current levels 
from the bipolar voltage signals. The hardware that receives the 
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RS-23ZC CONNECTIONS 

PIN 8 CARRIER DETECT 
PIN 6 DATA SET READY 
PIN 5 CLEAR TO SEND 
O PIN 3 TRANSMIT DATA 
PIN 1 CHASSIS GROUND 

O PIN 7 SIGNAL GROUND 



TRS-BO CASSETTE 
OIN CONNECTOR 



^—^AA O 

1,2 k!l 
V/i WATT) 



All resislors Vi wall unless noted 



20mA 
CURRENT LOOP 



E Z^OAlif 

25 V 



+ t2V ■ -12V 

Fig. 3-1 . Printer driver circuit for RS-232C and 20-mA current loop. 

serial data from the teletypewriter, as shown in Fig. 3-3, is more 
complex. Because of the nature of the TRS-80 cassette input and the 
format of serial data, an unconventional circuit is required. The de- 
tails describing this circuit are presented later in the chapter. 

The most universally accepted format was established by the 
Electronic Industries Association (EIA). The voltage format is 
known as the RS-232C, the C indicating that this is the latest re- 
vision. The Bell System developed this standard in cooperation with 
the EIA as the standard for interface between data terminal equip- 
ment and data communication equipment employing serial binary 
interchanges of information; that is, interchanges of one bit at a 
time. 

According to the standard, the voltage level under open-circuit 
conditions must not exceed a magnitude of 25 volts. The driver as- 
serts a voltage that is between -5 V dc and -15 V dc relative to 
signal ground to indicate a MARK condition (logic level 1), indi- 
cating the presence of a data bit. The driver asserts a signal level that 
is between -i-5 V dc and -fl5 V dc relative to signal ground to indi- 
cate a SPACE condition (logic level 0), indicating the absence of a 
data bit. Often chosen for the dc levels of MARK and SPACE are 
-12 V dc and -1-12 V dc. There are loading requirements in addition 
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TRS-80 CASSETTE NPN 
PIN CONNECTOR 2N22Z2 



PIN 2 O 



RS-Z3ZC CONNECTIONS 



A/W-O PIN 8 CARRIER DETECT 
2kn 



-^^W-O PIN 6 DATA SET READY 
.2 kiJ 



PIN 5 CLEAR TO SEND 
■O PIN 3 TRANSMIT DATA 

PIN I CHASSIS GROUND 

O PIN 7 SIGNAL GROUND 



All resislors Vt wait. 
Fig. 3-2. Alternate printer driver for RS-232C (not to specifications). 



20mA 
CURRENT LOOP 



TBS-80 CASSETTE 
DIN CONNECTOR 




RECEIVED 
DATA 

SIGNAL 



/0,405 R, 



Fig. 3-3. Input circuit for the reception of RS-232C and 20-mA current 
loop signals by the TRS-80. 

to the requirements for specific voltage levels. The load the receiver 
presents to the driver should be between 3000 and 7000 ohms. The 
driver must be able to function under the load presented by the re- 
ceiver and maintain voltages within the dc levels of +15 V dc and 
—15 V dc. Under no load conditions may this level rise above the 25- 
volt limit. 
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Physically, a 25-pin plug is often associated with this standard. 
The signal assignments for these pins are shown in Chart 3-1. Pins 
2 and 3 change their orientation depending on whether the device is 
the originating equipment or the terminal equipment. 



Charf 3-1. RS-232C Interface Circuit Functions 



Pin 1. Protective Ground — Electrical 
equipment frame and ac power ground. 
Pin 2. Transmitted Data— Data originated 
by the terminal to be transmitted via the 
sending modem. 

Pin 3. Received Data— Data from the re- 
ceiving modem in response to analog 
signals Transmitted from the sending mo- 
dem. 

Pin 4. Request to Send (RTS)— Indicates to 
the sending modem that the terminal is 
ready to transmit data. 
Pin. 5. Clear to Send (CTS)— Indicates to 
the terminal that its modem is ready to 
transmit data. 

Pin 6. Data Set Ready (DSR)— Indicates to 
terminal that its modem is not in a test 
mode and modem power is on. 
Pin 7. Signal Ground — Establishes com- 
mon reference between modem and ter- 
minal. 

Pin 8. Received Line Signal Detector 
(LSD)— Indicates to the terminal that its 
modem is receiving carrier signals from 
the sending modem. 
Pin 9. Reserved for test. 
Pin 10. Reserved for test. 
Pin 11. Unassigned. 

Pin 12. Secondary Received Line Signal 
Detector — Indicates to the terminal that 
its modem is receiving secondary carrier 
signals from the sending modem. 
Pin 13. Secondary Clear to Send — Indi- 
cates to the terminal that its modem is 
ready to transmit signals via the second- 
ary channel. 



Pin 14. Secondary Transmitted Data — 
Data from the terminal to be transmitted 
by the sending modem's channel. 
Pin 15. Transmitter Signal Element Timing 
—Signal from the modem to the transmit- 
ting terminal to provide signal-element 
timing information. 

Pin 16. Secondary Received Data- Data 
from the modem's secondary channel in 
response to analog signals transmitted 
from the sending modem. 
Pin 17. Receiver Signal Element Timing- 
Signal to the receiving terminal to pro- 
vide signal-element timing information. 
Pin 18. Unassigned. 

Pin 19. Secondary Request to Send— Indi- 
cates to the modem that the sending 
terminal is ready to transmit data via 
the secondary channel. 
Pin 20. Data Terminal Ready (DTR)- Indi- 
cates to the modem that the associated 
terminal is ready to receive and transmit 
data. 

Pin 21. Signal Quality Detector — Signal 
from the modem telling whether a de- 
fined error rate in the received data has 
been exceeded. 

Pin 22. Ring Indicator (RO — Signal from 
the modem indicating that a ringing sig- 
nal is being received over the line. 
Pin 23. Data Signal Rate Selector— Selects 
one of two signaling rates in modems 
having two rates. 

Pin 24. Transmit Signal Element Timing — 
Transmit clock provided by the terminal. 
Pin 25. Unassigned. 



The current loop is another widely used standard. It originated 
with Jean-Maurice-Emile Baudot, a French engineer. The principle 
in this communication link is the maintenance of a constant current. 
Two conditions are possible; the current flows, or it does not. Con- 
tinuity, or current flowing, denotes the MARK. The interruption of 
flow denotes the SPACE. At first, when the link is established, cur- 
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rent flows. An interruption of the circuit indicates the start of data 
transmission. The current on the line is switched on and off, and in 
this manner it is possible to send code for the character that is trans- 
mitted. A series of stop bits or logic ones indicates to the receiver 
that the code has been transmitted. The line remains closed until 
the start of the next character transmission. This method of sending 
information in single characters, rather than in blocks of characters, 
is called asynchronous communication. 

A popular current level used to indicate the presence of a data 
link is 20 mA, and you will often hear the reference made to the 20 
mA current loop communication link. 

The communication between the monitor and the listing device 
is asynchronous. By convention, serial teleprinter systems have 
adopted the idle, or wait, condition to be indicated by the MARK. 
Synchronization for a word of transmitted data is indicated by the 
presence of a start bit or SPACE, followed by 8 bits of data. The bit 
sequence for each character ends with a MARK which is transmitted 
for at least one bit time, and often for two, depending upon the con- 
vention that has been adopted for the communication loop. In true 
asynchronous form, the line remains in the MARK state until the 
next data word is to be transmitted. This format is the same for both 
standards, either voltage or current. The bit times are determined 
by the rate at which transmission is to occur. A typical sequence of 
logic levels for the 11-bit serial data (start bit, 8 data bits, and 2 stop 
bits ) is shown in Fig. 3-4. Data rates are often specified in baud, in 
honor of Jean-Maurice-Emile Baudot, who originated the Baudot 
5-bit code. 

The characteristic that is important in design considerations for 
the TRS-80 is the constant level of current or voltage if no bit 
changes occur in the serial transmission. For the TRS-80 to receive 



IDLE STATE TIME 
MARK CONDITION ' 



SPACE CONOITION 



START 
BIT 



-5 TO 8 DATA BITS - 



3 4 5 6 7 



MINIMUM STOP BITS 1. V/i. OR 2 



START BIT OF 
NEXT DATA 



LSB = Least significant bit. 
MSB = Most sigrilicani bit. 

Note: For 20mA, mark equals 20mA current 
space equals current 

For RS-232C. marll equals -3 to -15 volts 
space equais +3 to +15 voits 



Fig. 3-4. Serial data format for RS-232C and 20-mA signals. 
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this code, it is necessary to introduce a level change. This is covered 
in the section deaHng with the hardware. 

The software supporting the driver for the monitor assumes a data 
rate of 110 b/sec, which is the traditional speed used for teletype- 
writer-based communication links. This data rate results in the 
transmission of ten characters per second. A character is defined by 
an 8-bit code. The code is not Baudot, but the newer American 
Standard Code for Information Interchange (ASCII). This is a 
7-bit code, and the additional bit transmitted is used for simple 
error detection. This additional bit is called the parity hit. Its value, 
a one or zero, is used to make the sum of MARK bits in the word 
equal to an even number (in which case even parity exists), or to I 

make the number of MARKs in the word an odd number (to indi- 
cate odd parity). For example, the 8-bit ASCII value for the 
NUL is OOH if parity is even, and 80H if parity is odd. By conven- 
tion for teletypevnlter systems, there is one start bit and there are 
two stop bits, in addition to the eight bits required for the ASCII ^| 

character. This makes the number of bits transmitted per character 
equal to eleven. The bit time for transmission is 9.09 ms. 

The hardware shown in Fig. 3-1 converts the output from the cas- 
sette DIN plug to the EIA levels. In Chapter 1, it was shown that 
the output to the cassette is conti-olled by the logic levels on bits 
and 1 of port FFH to produce a voltage on pin 3 relative to pin 1 
on the DIN plug of the TRS-80. To refresh your memory, the follow- 
ing three states are used. A 00 ( OOH ) in the last two bit positions 
produces a dc level of 0.45 V, a 01 (OIH) produces a 0.85 V level, 
and a 10 ( 02H ) produces a 0.0 V level. This voltage is axoplied to the 
noninverting input of an operational amplifier (CA3140T). The am- 
plifier is operating at very high gain, and in this design functions as | 
a comparator. The reference voltage on the inverting input is ob- 
tained from a forward-biased signal diode ( 1N914 ) . The reference 
is approximately 0.6 V. The normal output to bits and 1 of port 
FFH is 00, and the 0.45 V produced is not sufficient to saturate the 
amplifier to -1-12 V. Therefore, the output to the RS-232C connector -*i 
is —12 V, the MARK level. Only the binary 01 in the last two bits 
produces the "true" SPACE (-H2 V level) and triggers the start-of- 
transmission signal. If a standard RS-232C connector is used on the 
printing device, the appropriate levels are applied to the Clear to 
Send, Data Set Ready, and Carrier Detect lines to allow the Hsting 
device to respond to a transmitted signal. The hardware also pro- 
vides the transistor circuit needed for a 20-mA current loop. The 
voltage or current levels are a function of the hardware, but the soft- 
ware that transmits the serial data to the listing device is the same, 
no matter which transmission standard is used. 

I 
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Fig. 3-2 shows an alternate form of the RS-232C interface. This 
does not meet the RS-232C standards, but the circuit functions well 
for most serial interfaces. Its most outstanding feature is its sim- 
plicity. Any voltage level less than -1-3 V dc results in a negative as- 
sertion, or MARK condition, on the RS-232C line. 

A software listing to produce hard copy is given. The software is 
activated by a toggle-type switch. This switch sets a flag, and when 
the processor is executing code at the end of the crt routine, it tests 
the flag to see if a hard-copy listing has been requested. If so, a call 
to the hard-copy routine is executed, and a single character is sent 
to the listing device. The toggle switch is activated by the L com- 
mand in the buffer during command execution. The hard-copy flag 
is set and reset with the L command. Of course, the L may stand 
alone or appear several times, but each time it is encountered it 
turns on or off the listing device. It is necessary for you to patch a 
three-byte jump instruction in the referenced R/W memory vector 
location to cause transfer to the program that supports your output 
device. This jump must be placed in locations 4018H through 
401 AH. The actual driver software may be placed in the RAM area 
or in ROM. Locations from 0800H through 37DFH in a Model I 
system are available if the monitor resides in the first 2K of ROM. 
In a Model III system, locations up to 37FFH are available, but you 
must avoid location 37E8H. This location in memory is used by the 
screen printer. If a Radio Shack printer is connected to your system, 
the status of the printer is available if you read data from this ad- 
dress. Data is latched in a special output buffer to drive the printer 
if you write data to this memory location. In the Model III, the hard- 
ware decode is supplied, so you could write your own software 
driver to take advantage of its presence. 

SERIAL INTERFACE DRIVER CODE FOR RS-232C 

An example of a driver program for the hardware described is 
provided. The structure of the software program is straightfor- 
ward. The first output is a 9.09 ms start pulse, followed by the 8-bit 
data stream (least-significant bit through most-significant bit), and 
ending with two stop bits. This rate is the standard 110 b/sec rate. 
To change data rates it is only necessary to change the length of the 
time delay used to output the MARK and SPACE levels. Table 3-1 
shows the factors to be used for delays for other data rates. 

The source code shown in Example 3-1 (see page 93) provides 
a routine to write to the RS-232C serial device. Data to be output 
must be placed in the C register before this program is used. This 
program must be entered into RAM, because it is not located in the 
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Table 3-1. Data late Factors for RS-232C Serial input 



Baud 


Model 1 


Model III 


110 


0268H 


02BDH 


300 


OODFH 


OllOH 


600 


006CH 


007BH 


1200 


0033H 


003BH 



FROLIC ROM. It has been written to reside at locations 4300H 
through 4339H, but it may be relocated if desired. 

The program listed may be entered into the RAM locations given 
using either the I command or S command. The jump ( C3H ) is en- 
tered into location 4018H, and 4019H and 401AH contain the data 
OOH and 43H using the Intel format. The object code may be stored 
on cassette tape for future use with the following command se- 
quence: 

W4018 3 L1ST1,W4300T4348 0000 LIST2<ENTER> 

To load this program when hard copy is desired, the following com- 
mand sequence is used: 

R,R<ENTER> 

You may now execute the L command and obtain a listing of all 
monitor activities. 

SERIAL INPUT 

It may also be desirable to be able to read data from a punched 
tape, a modem ( often used for telephone links ) , or an external key- 
board. The hardware presented in Fig. 3-3 can be used to convert 
the RS-232C levels from the external driver to levels that drive the 
input circuits of the TRS-80. This circuit may appear to be unusual 
unless you understand how the signals from the cassette are con- 
verted to TTL levels. The signal conditioner in the TRS-80 does not 
allow direct current amplification. Only ac voltages can be passed 
by the circuit to set the data latch. The TRS-80 circuit is a high-pass 
active filter with a two kilohertz breakpoint frequency. In order for 
the 110 b/sec signal to be transmitted to the data latch, it is gated 
with a higher frequency signal. The circuit consists of an oscillator 
and a logic gate. When the clock frequency generated by the oscilla- 
tor is gated with the serial transmission, the newly formed signal is 
suitably matched to the electronics of the TRS-80, and this gated sig- 
nal carries the data information contained in the serial signal. Fig. 
3-5 shows the gated clock signal produced by the hardware. The 
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XAMPLE 3-] 


ORG 4300H 






4300 F5 


TTYP 


PUSH AF 


SAVE REGISTERS 


4301 C5 




PUSH BC 


ON STACK 


4302 E5 




PUSH HL 




4303 79 




LD A,C 


DATA rW C REGISTER 


4304 F5 




PUSH AF 


NEED LATER 


4305 CD2143 




CALL TPOUT 


OUT DATA ON SERIAL DEVICE 


4308 Fl 




POP AF 


•RETRIEVE DATA 


4309 FEOD 




CP ODH 


•CARRIAGE RETURN 


430B CC1243 




CALL Z,LNFD 


•NEED A LINE FEED 


430E El 




POP HL 


•RESTORE REGISTERS 


430F CI 




POP BC 




4310 Fl 




POP AF 




4311 C9 




RET 




4312 3E0A 


LNFD 


LD, A.OAH 




4314 CD2143 




CALL TPOUT 




4317 0EO4 




LD C,4H 


•DO NOT NEED C ANYWIORE 


4319 AF 


NULLS 


XOR A 




431A CD2143 




CALL TPOUT 




431 D OD 




DEC C 




43 IE 20F9 




JR NZ.NULLS 




4320 C9 




RET 




4321 B7 


TPOUT 


OR A 


;CLEAR CARRY FOR START BIT 


4322 O609 




LD B,9D 


.START BIT PLUS 8 DATA 


4324 F5 


TPl 


PUSH AF 


;SAVE 


4325 D43643 




CALL NCSPACE 




4328 DC3C43 




CALL CAAARK 




432B Fl 




POP AF 




432C IF 




RRA 




432D 10F5 




DJNZ TPl 




432F CD3C43 




CALL MARK 


;TWO STOP BITS 


4332 CD3C43 




CALL AAARK 




4335 C9 




RET 




4336 3E01 


SPACE 


LD A.OIH 




4338 D3FF 




OUT{0FFH),A 




433A 1804 




JR DELAY 




433C 3E02 


AAARK 


LD A,02H 




433E D3FF 




OUT(0FFH),A 




4340 1800 




JR DELAY 


;KEEP STATE TIAAE SAAAE 


4342 216802 


DELAY 


LD HL,0268H 


;SEE TABLE FOR BAUD RATES) 


4345 2B 


DELI 


DEC HL 




4346 7C 




LD A,H 




4347 B5 




OR L 




4348 20FB 




JR NZ,DEL1 




4349 C9 




RET 





MARK produces a series of 0.25-ins pulses, while the SPACE in- 
hibits any pulses from passing through the gate. Thus, it is possible 
to latch the bits in the serial word, and write a program that can be 
used to convert the latched information into 8-bit words. The inter- 
nal TRS-80 set/reset register used for the cassette input indicates 
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PIN 3; 
./:.^0^^?^TOH Jlllll -- -K SPACE ^^ ^ ^^ ^^^ ^^ 

PIN 2. ^ N 1 llllllllll CASSETTE 



DATA FSOM 



=3> 



20mA OR ~T^-^ 1™'^'"- V OIN CONNECTOR 

RS-232C SOURCE gp.g, „„ I 

CONVERTED TO ^'^^^ " 

TTL LEVELS ' ' ' ^ ' ' 

INPUT SIGNAL OUTPUT SIGNAL 

Note: A mark will not set (Jaia latch. 
A space Will set data latcli. 

Fig. 3-S. Forming a data latch signal for the TRS-80. 

the presence of a data pulse in the data stream. Before any data can 
be read, the latch must be cleared. After a pulse is detected in the 
input stream of serial bits, the latch is set. To reset the latch after 
each bit has been detected, it is necessary to do an output to port 
FFH. Port FFH, you may recall, is used for both reading and writing 
of data during cassette operations. In this application, we are using 
these inputs to detect serial data. There are upper limitations on the 
baud rate, but HO and 300 b/sec are possible with the hardware 
shown. The software program given in Example 3-2 accepts data 
from the cassette input and writes it to the screen. You must alter 
this software to tailor it to your own requirements. If a hard-copy 
driver is resident, you may "echo" or transmit the data to this device. 
The patch to the external keyboard is made through the U command, 
so the appropriate jump must be placed at 401BH through 401DH. 

SERIAL INTERFACE RECEIVER FOR RS-232C 

Note: this program allows reading of an RS-232C signal from an 
external device connected to the cassette input DIN connection. 
Upon return from this routine, the accumulator contains the 8 bits 
of the received character. Because of the many general applications 
of this program, you may wish to modify it. 

The hardware described in this chapter is not required for estab- 
lishing data links between two TRS-80 computers. Data transmis- 
sion using the cassette plug is possible if phase or frequency coding 
is used to format the data. This is the type of format used to produce 
a TRS-80 cassette tape. It is necessary to provide a voltage gain for 
the cassette output signal to raise its level to drive the cassette input 
of another TRS-80 computer. The input impedance to the amplifier 
is 100 ohms, which is relatively low, so some additional drive capa- 
bilities are required. A comparator is used to raise the level of 0.85 V 
dc to a TTL level. Fig. 3-6 shows a suitable driver. 

We have used the TRS-80 cassette input/ output for data trans- 
mission rates of 5000 b/sec. This is only possible if the TRS-80 cas- 
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Example 3-2. 



ORG 4400H 
HALFD 



DELI 



DELS 



EQU 0133H 



EQU OICDH 



EQU 0099H 



4400 D9 KEY 


EXX 


4401 AF 


XOR A 


4402 D3FF 


OUT (OFFH),A 


4404 3A8038 KEYl 


LD A,(3a80H),A 


4407 B7 


OR A 


4408 CA6600 


JP Z,0D66H 


440B DBFF 


IN A,COFFH) 


440D 17 


RLA 


440E 30F4 


JR NCKEYl 


4410 0608 


LD B,08D 


4412 113301 


LD DE, HALFD 


4415CD3244 


CALL DELAY 


4418 11CD01 BYTE 


LD DE.DELl 


441 B CD3244 


CALL DELAY 


441 E AF 


XOR A 


441 F D3FF 


OUT (OFFH)/> 


4421 119900 


LD DE,DEL3 


4424 CD3244 


CALL DELAY 


4427 DBFF 


IN A,(OFFH) 


4429 17 


RLA 


442A CB19 


RR C 


442C lOEA 


DJNZ BYTE 


442E 79 


LD A.C 


442F 2F 


CPL 


4430 D9 


EXX 


4431 C9 


RET 


4432 IB DELAY DEC DE 


4433 7B 


LD A.E 


4434 B2 


OR D 


4435 20FB 


JR NZ.DELAY 


4437 C9 


RET 




END 



iSTART OF PROGRAM 
HALF DELAY TIME 
(070H FOR 300 BAUD) 
3/4 DELAY TIME 
{0A9H FOR 300 BAUD) 
1/4 DELAY TIME 
;(038H FOR 300 BAUD) 

SAVE REGISTERS 

CLEAR ACC TO USE IN OUTPUT 

RESET DATA FLAG 

SEE IF SHIFT PRESSED 

ESCAPE FROM READ 

RETURN TO MONITOR 

LOOK FOR START BIT 

BIT 7 SHIFTS TO CARRY 

;BYTE OF DATA 
;HALF DELAY TIME 
;CENTER POSITION 
;DELAY 3/4 BIT TIME 



;CLEAR DATA FLAG 
;QUARTER OF DELAY TIME 

GET DATA 

PUT IN CARRY 

SHIFT INTO C 

GET 8 BITS 

DATA INTO AC FOR RETURN 

COMPLEMENT DATA 

RESTORE REGISTERS 

RETURN TO CALLING PROGRAM 



;RETURN TO CALLING PROGRAM 



sette hardware patch has not been installed on the units. In addi- 
tion, different data formats and lower input levels are required 
(0.85 to 1.2 V dc). To see if your unit is modified, examine the serial 
number. If it has a -01 appended, the modification has been installed 
and must be removed to obtain higher baud rates. In the high-speed 
communication link, the cassette is not used. Only for direct com- 
munication between TRS-80s and other TTL compatible inputs is 
the link used. For example, we use this method to down-load pro- 
grams assembled on the TRS-80 to Intel SBC 80/10 and 80/20 sin- 
gle-board computers. 
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PIN 3 O- 

OUTPUT FROM 
TRS-80 CASSETTE 1N914 ^ 

DIN CONNECTOR 

PIN 2 O- 




NPN 2N2222 

OR, FOR MULTIPLE DRIVE UNITS. 

NPN TIP 30 OR 2N3055 



INPUT TO 
TRS-80 CASSETTE 
DIN CONNECTOR 



DESTINATION UNIT(S| 



Fig. 3-6. A master-slave connection between TRS-80 computers. 

Most small hobby computers use low-cost cassette recorders and 
cheap cassettes. In the TRS-80 Model I system, reliability is a prob- 
lem. Overall system performance depends on the quality of the 
recorder and the quality of the tape, and not on the format used. 
Significant improvement in the cassette electronics allowing in- 
creased speed is provided on the Model III system. To take full ad- 
vantage of the higher speed, the time delay routines must be altered 
in the monitor. However, to maintain compatibility between the 
two systems, the 500 b/sec data rate was maintained in the monitor 
listing. 
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CHAPTER 4 



PROM Programmer 



After an often used program has been developed and tested, you 
might want to store the object code in nonvolatile memory, that is, 
in Programmable Read-Only Memory (PROM). The use of PROM 
allovifs the system designer to remove power knowing that once 
power is restored the program is available immediately to perform 
its intended function. A software and hardware option controlled 
by the monitor supports the programming of PROMs, in particular 
both the 2708 and 2716 EPROMs. The EPROM is an Erasable Pro- 
grammable Read-Only Memory. The satisfaction received in seeing 
the object code of your program execute in a stand-alone turnkey 
operation is worth the development effort. The ROM that contains 
the object code that defines the TRS-80 development system is one 
such example. Since all mnemonic listings and commented source 
codes are listed in the appendixes, you could now delete or add in- 
structions to customize the system for your own personal use. Space 
has been provided in the command look-up table for user-generated 
commands. The U command as previously explained has a jump to 
a RAA-I address at which you insert a jump to your program. The 
P command is reserved for PROM programming. The object codes 
for programming several popular EPROMs are given in this chapter. 
If EPROM programming is not desired, this monitor command may 
be used for an alternative purpose. The other commands, not used 
by the monitor but in the command table, nevertlieiess, have been 
assigned restart instructions in place of any two-byte address. The 
RST 38 ( FFH ) is used for this purpose because an FFH state is the 
condition of an erased EPROM location. Furthermore, this pattern 
as an instruction is used for returns from breakpoints. Accidental 
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use of one of these instructions returns control to the monitor with- 
out loss of system control. The FFH allows you to program jumps 
directly into the command table without a branch to RAM location. 
As will be shown later, the monitor ROM is first transferred to a 
clean EPROM using the program option. The jumps are then pro- 
grammed "over" the FFH instructions. There is provision on the 
TRS-80 board for an additional 2K EPROM (2716). 

ERASABLE PROGRAMMABLE ROMS 

The most popular programmable read-only memory to program is 
the erasable type (EPROM). This EPROM family was first intro- 
duced by the Intel Corporation. The availability of EPROM devices 
made the rapid development of microprocessor control systems pos- 
sible. The only nonvolatile memories prior to EPROM were core 
memory, fusible-link memory, and masked read-only memory. Core 
memory is expensive, since it must be strung by hand. Masked and 
fusible devices, once programmed, are totally useless if an error is 
accidentally programmed into the device. With EPROM, however, 
high-intensity short-wave ultraviolet light can be used to erase the 
device. These light sources are readily available for many suppliers. 
Programming errors are more frequent than one would care to admit. 

EPROM Physics 

An elementary description of how the ultraviolet erasable 
EPROM operates is now presented. The actual memory element is 
an insulated-gate metal-oxide-semiconductor field-effect transistor. 
The conduction state of the device is controlled by the gate. If the 
transistor is biased in the conduction mode, one logic state is as- 
serted, and if it is biased in the nonconducting mode, the opposite 
logic state exists. Through manufacturing methods, the gate may be 
isolated as well as insulated. The insulation makes the impedance 
extremely large. The isolation plays another significant role, as you 
will soon learn. There is an inherent capacitance present because of 
the physics of the device (two plates separated by a dielectric). 
Through the use of various manufacturing techniques, this capaci- 
tive efi^ect may be exaggerated. The presence or absence of charge 
on this capacitor determines in which state of conduction the tran- 
sistor is operating. Once the capacitor is charged, the isolation pro- 
vides no discharge path. To program the device, high voltages are 
used to break down the insulating dielectric and charge the capaci- 
tor. Eight capacitors attached to eight gates determine the program 
pattern of one word or byte. The state of charge on these capacitors 
is determined by the programming word, and only those gates whose 
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state of conduction must be altered are altered. Once programmed, 
the device has a very long retention of the data pattern. Statistics 
show that in most cases the EPROM does not lose its pattern over the 
lifetime of the equipment in which it is operating. 

The method used to erase the EPROM is to expose the device to 
high-energy short-wave ultraviolet light through its specially con- 
structed quartz window. The energy from the radiation breaks down 
the dielectric and allows the capacitor to lose its charge. All this takes 
place in a controlled environment in order to prevent damage to the 
EPROM. The time period for the process is about 20 minutes for 
currently available devices. Once erased, the EPROM can be repro- 
grammed. If equipment using the EPROM is exposed to high-inten- 
sity UV radiation and no protection to the device is provided, f aUure 
in operation is to be expected. 

Programmable EPROMs 

Many types of PROMs may be programmed with the monitor de- 
velopment system through the use of the P command. Prior to using 
the P command, the EPROM programmer software must be entered 
into RAM memory for execution. Preferably, this should be done 
from cassette tape using the R command. Two things must happen 
for a successful load. The jump instruction with appropriate address 
must be entered into 401BH through 401DH, and the object code for 
the programmer must be entered, starting at the address of the 
jump. Three EPROM programming routines are presented in this 
chapter along with the necessary hardware that will allow use of 
these programs. 

The first EPROM described is the 2780 multivoltage device, 
which was introduced by Intel Corporation. These EPROMs are 
contained in 24-pin dual in-line packages and require three voltages 
to operate (4-12, +5, and -5 V). In addition, a +25 V programming 
pulse is required in the programming mode. This EPROM is second- 
sourced by many manufacturers. The data storage capacity of the 
EPROM is 1024 words of 8 bits each, or IK X 8. A second device 
with larger memory storage was introduced by Texas Instruments 
Inc. (TI), the TI 2716. Programming it is the same as programming 
Intel's 2708. In this case, the storage capacity is 2048 words, or 
2K X 8. 

Intel also produces a 2K EPROM, but it is a single-voltage 
EPROM. This EPROM still requires a high voltage to program it, 
but the process is much simpler. A programmer for these devices is 
included in this chapter, and the details are presented in the section 
devoted to the programming process. Intel chose to call this 
EPROM a 2716. (This is not a printer error, the number is the same! ) 
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At the same time, they introduced a +5 V dc IK EPROM, caUing it 

a 2758. These are most hkely rejects from the 2716 processes with 

only half of the unit functional. A similar case occurred with the 

yields from the 2708 devices, producing the 2704 EPROM, a 512- 

byte version of the IK device. ( In any event, one must now be care- | 

ful to note the manufacturer of the EPROM, as well as the type 

number of the device. ) ; 

Texas Instruments also supplies a single-voltage 2K EPROM, the 
2516. Both the 2716 and the TI 2516 devices are pin compatible and 
available in a 24-pin dual in-line package. The memory capacity of J 

EPROMs keeps expanding, and 4K single-voltage versions are avail- 
able from many sources. 

The last device considered in this chapter is more than an 
EPROM. In addition to the programmable memory, the device in- 
cludes two input and/ or output ports. It is directly compatible with 
the 8085 and 8748 microprocessors. This multipurpose IC is the 
8755 and is manufactured by Intel Corporation. With a little "hard- 
ware" overhead, it can function on a Z-80 system such as the TRS-80. 
However, it is assumed that the 8755 will operate in an 8085 system 
such as the three-chip set described in the 8085 literature. The mem- 
ory capacity of this device is the same as the capacity of the 2716. | 
The programming of this EPROM is another variation of the tech- J 
nique used for the Intel 2716, but in addition there is sharing of 
address and data lines. Another difference exists in the packaging of ; 
the 8755, a 40-pin dual in-line device. It requires a special program- 
ming socket to accommodate the larger size. 

Fig. 4-1 shows the pin configurations for the various EPROMs ''' 

that can be programmed by the monitor system. The software pack- 
ages given herein can program all of these devices. The user may 
wish to modify the software and hardware to program the 2732 ( a 
4K version of the 5 V 2716 EPROMs). But, there are critical differ- 
ences in the pin functions between these two EPROMs. Also be 
aware that the program pulse is active low on the 2732 EPROM. A 
sHght modification is necessary to program the Intel 2758 or TI 2508. 
The pin for the TTL programming pulse is changed, and a software 
correction is required. Refer to the programming specifications from 
the manufacturer if it is necessary to program this device. 



PROGRAMMING CONSIDERATIONS 

Before the hardware is considered, a brief presentation of the pro- 
gramming of these three famihes of EPROMs must be presented. 
The programming methods as well as the number of voltages re- 
quired to operate the device do influence the hardware design. The 
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one item common to all EPROMs presented in this text is their 
erased state, FFH in all locations. 

The programming of the multivoltage devices is substantially 
different from the programming of the single- voltage EPROMs. This 
is true whether the device is a IK or 2K byte EPROM. A more com- 
plicated procedure is required for tlie multivoltage devices, since 
these devices must be programmed sequentially in large blocks. The 
blocks are programmed many times in order to guarantee adequate 
programming. The exact process for programming may be obtained 
from the specification sheets provided by the manufacturer of each 
particular EPROM. For the most part, Intel specifications are used 
in the programs presented. The following sequence is necessary in 
the programming of the 2708 family of EPROMs. 

The procedure for a program sequence starts with applying 4-12 
V dc to the PROG/CS pin. The voltage at this pin remains high dur- 
ing the entire programming process. The address of the location to 
be programmed is placed on the address lines, followed by the data 
byte on the data lines. Some settling time is required so that all the 
signals can become stable before the programming pulse is applied. 
Twelve ^is is a sufficient time, and the short delay caused by the 
instruction fetch and execute time fills this requirement. Next, a 
programming pulse is applied to the programming pin. The ampli- 
tude of this pulse is -1-25 V dc, but its width may vary according to 
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a predetermined relationship. (Intel specifies +26 V dc, but other 

manufacturers specify +25 V dc. The 25 V specification was used in 
the design of the programmer described.) The pulse may range 
from 100 /U.S to as long as 1000 fis. An empirical relationship between 
the number of program cycles and the width of the pulse has been 
established by Intel. (A program cycle is the time required to ad- 
dress and program all the locations within the EPROM.) If the pro- 
gram pulse is too wide, damage caused by overheating a location 
will result. If the pulse is too short, breakdown of the dielectric can- 
not be guaranteed, and an infinite number of cycles could not pro- 
gram the device. Hence, the two extremes are established. 

A wide pulse allows a greater charge to be passed to the isolated 
capacitor. Hence, programming should occur with fewer passes. Con- 
versely, the shorter pulse width allows a lesser charge to flow to the 
capacitor. Thus the relationship between the width and the number 
of passes is established. The product of the number of passes and the 
pulse width must be at least 0.1 second to ensure that proper pro- 
gramming has occurred. For example, if the width of the pulse is 
one ms, then 100 passes would be the minimum number to ensure 
proper charge on the capacitor. Extending the number of passes 
does not ensure a better programmed word, since the charging of a 
capacitor is governed by an exponential relationship, and a large 
number of addition cycles provides only a slight increase in the 
charge. The charging of the capacitor could come about using a 
shorter pulse, in which case more passes would be required. If the 
pulse width is reduced to 100 jjls, then 1000 passes would be required 
to obtain the same effective charge as that obtained with .the one ms 
pulse width. These two extremes define the permissible program- 
ming time for the EPROM. Stated mathematically, 

N ^ 0.1/twp 
where, 

N is the number of program cycles, 
twp IS the width of the program pulse. 

The program sequence requires incrementing the address, apply- 
ing the new data byte to be programmed, and then turning on a 
program pulse. This process must be repeated N times before the 
programming has been properly accomplished. Programming all 
locations of a 2708 device takes approximately 2 minutes. 

If partial programming of a 2708 device is required, the data loca- 
tions to be programmed are loaded in the usual manner, but the pro- 
gram cycle must artificially introduce a time period to compensate 
for the time absent from the program loop because not all locations 
are being programmed. This prevents damage to the programmed 
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device. One method used to create the delay is to program the same 
data that exists in the chip, changing only those locations in which 
the data is to be altered. This may be accomplished by transferring 
the data existing in the EPROM into a buffer area in spare memory, 
altering the locations in which changes are to be made, and then 
proceeding to program the entire block as if it were the first time 
that the EPROM was being programmed. 

SINGLE-VOLTAGE EPROMS 

The programming of the single-voltage devices is a much simpler 
process. In addition to the hardware differences, the controlling soft- 
wai-e is dramatically changed. The significant difference is that any 
location can be altered, providing the new pattern is compatible 
with the old pattern. The programming may be done in a random 
fashion. To program the 2716, the following sequence is performed 
in the programming algorithm. To initiate the program mode, a 
+25 V dc programming voltage is applied to the program pin. The 
high voltage is not pulsed but is constant. This voltage must be 
applied after power-up (that is, the -t-5 V dc is applied to the chip 
fi'-st), and it must not make a transition from to 25 volts. The only 
allowable transitions are -r5 V dc to +25 V dc and -F25 V dc to 
-1-5 V dc. It may be only the Intel device that does not allow this 
transition, but in the hardware and the software presented, only the 
5-to-25 and 25-to-5 volt transitions are possible. The device can be 
programmed in any order, but the new data pattern must not con- 
flict with the data to be written over. This means that a zero may be 
programmed in any location where a one exists in the byte pattern, 
but a one cannot be programmed over a zero. The programming is 
accomplished with a single 50 ms, -1-5 V pulse on the Vpp pin. 

If the system microprocessor is 8080 compatible, it may be desired 
to program OOH in all unused locations, since a OOH is a no operation 
(NOP) instruction. 

8755 EPROM I/O CHIP 

The 8755 is not programmed in the same fashion as the Intel 2716 
device. The random, single-programming pulse technique is used, 
but in this case, the pulse is on the -1-25 V dc line. Other changes 
include a large socket holder that must now hold a 4-pin package, 
and shared data and address lines. In the programmer design, the 
EPROM is connected to the common function pins of the 2716, ex- 
cept that the only address lines connected are the high-order bits 
8, 9, and A. The data and the low-order address share the same pins. 
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This is accomplished with the address latch enable (ALE) signal, 
which is not directly available with a Z-80 based system, but may 
be simulated with the software to allow both the programming and 
verification of data. Other lines support the memory and input-out- 
put functions. 

EPROM PROGRAMMER HARDWARE 

The hardware used to program the EPROMs uses an 8255 pro- 
grammable peripheral interface (PPI) chip. This chip is available 
from many sources at a reasonable cost. While it is possible to build 
the programmer for under $20 if zero-force insertion sockets are 
avoided, you would be wise to use these sockets to avoid damaging 
the expensive EPROMs. In connecting the EPROM programmer to 
the TRS-80 bus, the address hues are buffered, but the data lines are 
not. Separate sockets for 2716, 2708, and 8755 EPROMs are used in 
the design. You must be extremely careful not to plug a single-volt- 
age device into a multivoltage socket. Also, be aware that the pro- 
gramming circuitry is connected to all device sockets, so only one 
EPROM device should be installed for any one programming ses- 
sion. Violation of this rule will result in permanent damage to the 
EPROM. BE CAREFUL! 

Fig. 4-2 outlines the circuit of the EPROM programmer, and Figs. 
4-3 through 4-6 show details for specific EPROMs. The -1-25 V dc 
source is shared by all devices. To program 2708 devices (Fig. 4-3), 
this voltage source must be able to sink several milliamperes. This 
explains the presence of a special active current sink in the design. 
The single-voltage 2716s and 8755s require that this voltage go from 
-f-5 to +25 V dc, instead of from to 25 V, so the circuit design re- 
flects this requirement (Figs. 4-4 and 4-5). The difference in the ap- 
plication of these voltages is determined by software, and is depen- 
dent upon which device is to be programmed. For example, the 2716s 
allow this voltage to be constant while the EPROM is being pro- 
grammed, whereas the 8755s require that the voltage supplied be a 
programming pulse of 50 ms duration. Yet another requirement ex- 
ists for programming the 2708s, since these reauire or -M2 V dc 
to be applied to the chip select /program enable line (CS/PROG) 
instead of the normal TTL levels of and -1-5 V dc. 

To program the Texas Instruments TI2716s. which you recall are 
programmed in a manner similar to the 2708s, more hardware 
changes are needed (Fig. 4-6). The change shown allows the selec- 
tion of either the upper or lower IK sections of the EPROM. With 
this modification, the software routines supplied can program the 
TI device, providing it is done in two sections. 
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Fig. 4-2. The basic iPROM programmer. 
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If you have no intention of programming a particular EPROM, 
the implementation of the corresponding hardware is not necessary. 
The major feature to consider is the flexibility that this particular 
EPROM programmer provides. 




Fig. 4-3. 2708 EPROM programming circuitry. 

The flexibility of the EPROM programmer is provided by the 
8255 PPI, a very powerful device. A detailed explanation of this 
chip is available from the specification sheets. Another excellent 
reference is Goldsbrough's book^, which is devoted to the 8255 PPI 
interface chip. The monitor software utilizes mode (not to be con- 
fused with interrupts) for programming, reading, and verification. 
Since a particular port on this chip may be either an output or an 
input ( a function of the control word used to initialize the device ) , 
data may be written on the data lines for programming and read 
from the data lines for verification. Also note that the RESET line is 
active high. At power-up it is necessary that all ports be configured 
in the input state, producing a high-impedance state at their corre- 
sponding pins. Pull-up resistors guarantee that no high voltages are 
applied to an EPROM socket while in the initialization process. It 
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Fig. 4-4. Circuitry used to program the 2716. 

is best to keep all EPROMs out of sockets until it is time to program 
them. 

The following port assignments are made on the 8255 and can be 
verified by observing the circuit diagram. Port A is used for data 
and changes from an input to an output depending upon the func- 
tion and the use of the appropriate control word. Bits through 7 
are connected to the data lines of the 2708 and 2716 EPROMs. The 
monitor addresses this port with an 8CH. When programming the 
8755s, these lines are used for both data and address information. 
You may observe this by noting the connections on the 8755 socket. 

Port B, addressed by the monitor with 8DH, is used for low ad- 
dresses in both the 2708 and 2716 devices, but not for the 8755. Port 
A is used in this case. 

Port C, addressed as 8EH, is used for both address information 
and control in the programming of all EPROMs. The four least sig- 



109 




82S5 

37 

38 
39 
40 
1 
2 
3 
4 

16 
15 
14 
25 
24 
23 
22 
21 
20 
19 
18 



Fig. 4-5. Programming circuitry for 
8755 EPROM I/O. 



■From 2716 driver Circuit, see Fig. 4-4. 















SW, 








-TT-e-Vrr 








O^ 












1 






1 






ypRiFV 9 




2 




23 


2 




23 




s e^Vf 
















3 




22 


3 




22 


,.nr.rr. 




~ 




21 


4 




21 


^ 




5 




20 


5 




20 






















6 




19 "" 


6 




19 

















— 


SWj 




7 




18 


7 




18 






















8 




17 


8 




1/ 






9 




16 


9 




16 






10 




15 


10 




15 






11 




14 


11 




14 






12 




13 


12 




13 






EXISTING SOCKET 


TI2716 SOCKET 





PIN 18 PULSE = 25 V DC 

Note: All pins except pins 20 and 24 interconnect directiv io equivalent locations Irom the 2708. 

Fig. 4-6. Programming the Tl 2716 with 2708 circuitry. 

niflcant bits are used for addressing. The remaining bits are used for 
control purposes that provide the program pulses or voltage levels. 
The function depends upon M^hich device is to be programmed. 
Hovi'ever, the four most-significant bits have dedicated EPROM 
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device functions. The specific allocation of each pin is given in the 
software-hardvi'are section for programming a particular class of 
EPROM. The last port address, port 8FH, is used to supply the con- 
trol word that determines the port configuration of the 8255. 

There is a general method of implementing the EPROM routines. 
Depending upon which EPROM family is to be programmed, the 
particular software to drive the programmer must be entered in 
memory. These software routines are provided in the sections cover- 
ing each EPROM family type. If relocation is necessary, it is best 
that it be done with an editor /assembler. After entry and verification 
of the object code, the program may be stored on cassette tape. This 
is done using the W command. How the jump vector is loaded into 
locations 401BH to 401DH is a matter of choice. The vector may be 
entered using the monitor at the time the tape containing the 
EPROM program is loaded. An alternative is to produce a tape con- 
taining the jump information using the W command to save the 
three bytes that form the jump. Assuming the object code to be used 
for programming an EPROM is loaded at 443FH through 47B4H 
and the code to support the jump vector is entered at 401BH through 
401DH, execution of the following statement on the monitor saves 
the jump vector and the program on cassette tape for future use: 

W401B 3 0066 PSTART,W 443FT47B4 0066 EPROMl<ENTER> 

The execution address is always loaded into the program counter. 
A safe re-entry into the monitor at location 0066H is the same as 
pushing the reset push button. When it is necessary to program a 
specific family of EPROM, the tape is read using two R commands: 

R,R<ENTER> 

After loading the program, executing the P command causes the 
monitor to execute the EPROM programming software. All the 
reading, verification, and programming options are then available. 

In the presentations that follow dealing wdth the EPROM fami- 
lies, the first section gives the pin assignments, and a second section 
lists the source code to be used to "drive" the EPROM programmer. 

PROGRAMMING THE 2708 EPROM 

To program the 2708 EPROM it is necessary to supply addresses, 
data, and control pulses to the device. The addresses are latched at 
ports B and C on the 8255. The 2708 is a IK EPROM, so ten address 
lines are required (Ao through A9). The low byte address hues 
defining the location of the data word to be programmed are at- 
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tached to port B bits through 7, which equate to address lines 

through 7. Addresses A8 and A9 are connected to port C, bits 
and 1. Bits 2 and 3 are not used in this programming module. Al- 
though not documented in this section, these bits could be used for 
programming the TI2716 if appropriate hardware and software 
changes are incorporated. ( Note that it is possible to program the 
TI2716 with the hardware presented using the modification shown 
in Fig. 4-6. This modification treats the TI2716 as two IK sections 
with each section programmed independently, as previously noted. 
A switch controls which block is addressed by the EPROM pro- 
grammer. ) Bits 4 and 5 of port C are used for control of dc levels 
and for the programming pulse. Chip select and program (CS/ 
PROG) pin 20 of the 2708 is controlled by bit 4. In the program- 
ming process, this terminal must be driven at 4-12 V dc to provide 
the program enable (PROG) function. To accomplish this in the 
design, an open-collector TTL device (74LS06) is used with pull-up 
resistors to +12 V. Bit 5 of port C supplies the programming pulse 
that is applied to pin 18 of the 2708. The duration and the number 
of programming loops are determined by the software. The data is 
applied to the 270S through port A. During reading and verifying 
the programmed bytes, this port changes directions and becomes an 
input port, and the data is read by the monitor through this port. The 
control word of the 8255 determines the direction of data flow. The 
remaining pins of the 8255 are not used in the programming, read- 
ing, and verifying of 2708 EPROMs. These bits are masked with the 
software to appropriate levels to prevent possible damage to other 
devices when the 2708 command function is executed. 

The sequence for programming the 2708 requires the presence of 
a block of data of 1024 bytes. If you must program only a few loca- 
tions, transfer the contents of the EPROM to a buffer, and change 
the locations in question. Remember that a 2708 location that con- 
tains FFH can be programmed to any pattern, and that only the Is 
in a bit pattern can be programmed to Os. Thus, it is possible to 
"write over" a programmed location without first erasing the 
EPROM, but only logic Is may be changed to logic Os, and not vice 
versa. With this technique, you can program any number of bytes. 
The program suppHed uses this method for programming shorter 
blocks. 

In the development of the software used to program the 2708s, the 
following procedure is used: Port A is configured as an output port 
for data. Port B and port C, bits 1 and 2, are also configured as out- 
put ports, and they hold the address information. The address of the 
EPROM location to be programmed is transferred to the 10 bits of 
the designated address ports. Port A is then set with the data word 
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to be programmed. The high-order bits of port C perform the fol- 
lowing functions. First, bit 4 is set high, enabling the write enable 
line ( PROG ) . Next, after a delay of at least 12 /xs, which allows the 
data and address lines to stabilize, the programming pulse is acti- 
vated by writing a 1 to bit 5 of port C, while keeping all other bits 
unchanged. This write pulse is maintained for a time that may vary 
between 100 and 1000 /as. This is a function of the processor clock; 
the software must reflect the correct time delay for the Model I or 
Model III. This wait period defines the pulse width of the program- 
ming pulse. Bit 5 is reset after the selected pulse, and all other bits 
must remain unchanged. The programming procedure is repeated 
for the next EPROM address until all desired words have been pro- 
grammed. At this point, one loop has been programmed, and the 
process must continue over again until the loop requirement is satis- 
fied, that is, until each EPROM location has been programmed the 
connect number of times ( corresponding to the ratio of the total pro- 
gram period to the pulse width period, which equals the number of 
loops ) . 

Using the EPROM Programmer 

After the program to be put in the EPROM is available on cassette 
tape, available in another EPROM, or entered using the monitor, the 
programming session can start. Be sure the software contains the 
correct time delay for the model in use. If the program to be put into 
the EPROM is on tape or is to be entered using the monitor, the pro- 
gram should be placed in memory above 5000H. The EPROM pro- 
grammer uses most of the R/W memory below 5000H. If the data 
to be programmed is available in a compatible ROM or previously 
programmed EPROM, then it can be entered using the R command 
described below. 

Five commands are possible in the EPROM programmer mode. 
All commands are interactive; that is, return to the monitor functions 
occurs only if requested. To terminate a command without returning 
to the monitor, use the <SHIFT> key. The programmer message: 

2708 EPROM PROGRAMMING PROGRAM 
> 

appears on the crt screen. This is the same message that appears 
when the P command of the monitor is used. 

Read Command 

The first command is a read (R), in which the contents of an in- 
serted ROM or EPROM are transferred to the addresses specified 
by the user for possible review and modification. The first field deter- 
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mines the placement of the data read from the ROM or EPROM, and 
the second field determines the number of data bytes to be read. The 
third field is an offset in the EPROM start address. If you wish the 
first location in the EPROM to be loaded in the first RAM location 
specified, this field may be omitted in the command: 

R 5000T53FF 000<ENTER> or, R 5000 400 000<ENTER> 
R 5000T53FF<ENTER> (no offset) 
R 5000T52FF 100 <ENTER> 

The data in the EPROM locations specified is transferred to memory 
starting at address location 5000H. If no offset is given, or if it is 
OOOH, the data in the first location is transferred to 5000H. If an 
offset is present in the command, the transfer from the EPROM 
starts at the offset address and continues until the entire block length 
specified is transferred. 

Verification Command 

The second command allows verification ( V ) of all or part of the 
data within the EPROM. The data to be verified must be loaded into 
the monitor from a cassette tape, another ROM or programmed 
EPROM, or code already present in R/W memory. Assuming that a 
previous read command loaded the data to be verified with the con- 
tents of the EPROM, then: 

V 5000T53FF 000<ENTER> or, V 5000 400<ENTER> 

compares the data in the EPROM with the data at memory locations 
5000H through 53FFH. Any discrepancies appear on the crt screen. 
The format shows the address and data in the memory followed by 
the address and data in EPROM. For example the crt display shows 

MEMORY: XXXX XX PROM: XXXX XX 
XX DESCREPANCIES 

for each discrepancy, and terminates the list with the total number 
of differences in the range indicated. Any block length can be speci- 
fied. 

Programming Command 

The third option is the programming (P) command. Any number 
of data bytes can be programmed. The data to be programmed is 
entered by one of the methods described for the verification com- 
mand. The programming time is approximately 2 minutes and is in- 
dependent of the block length. The format for this command is 

P 5000T53FF 000<ENTER> or, P5000 400<ENTER> 
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which takes the data present at locations 5000H through 53FFH and 
places it into EPROM locations OOOOH through 03FFH. As with the 
read and verify commands, it is not required to start at the first loca- 
tion in the EPROM. For example, assume you wish to program loca- 
tions 0050H through 014FH of the EPROM with the data located 
from 5230H through 532FH. The format to perform this program- 
ming function is as follows: 

P 5230T532F 50<ENTER>, or P5230 100 50<ENTER> 

The programmer automatically verifies the data in the EPROM with 
the data in R/W memory. Any differences are shown using the same 
format as that used in the verification mode. It is possible to program 
only one byte of a 2708 EPROM, but the time required is the time 
of programming all locations within the EPROM. 

Short-Cycle Program Command 

You may also request the short-cycle (S) option by using the 
fourth command, which programs the EPROM and then verifies it 
after each programming loop through the block being programmed. 
In this way, time is saved, since all of the loops may not be reauired 
to program the EPROM successfully. To be sure that the EPROM 
has been completely programmed, the short-cycle program repro- 
grams the EPROM for several additional cycles. This programming 
method may save you some time during program development, but 
it does not meet the manufacturer's specifications and should not be 
used for the final programming of the EPROM that will be used in a 
product or application. To use the short-cycle programming, the 
following command is used: 

S 5000T53FF 000<ENTER> or, S 5000 400<ENTER> 

This command performs the programming function of transferring 
the data at memory locations 5000H through 53FFH into EPROM 
locations OOOOH through 03FFH. Programming continues until ver- 
ification shows no errors. This produces a programmed device in 
less than 30 seconds when a new 2708 EPROM is used. 

Exit Programmer Command 

The final command, 

E<ENTER> 

allows return to the FROLIC monitor for the monitor functions. 

Program Locations for the 2708 EPROM 

The software shown in Appendix F is annotated in the hope that 
you can follow the programming sequence and add or remove code 
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as you deem appropriate. The address to be placed in the jump vec- 
tor locations 401CH and 401DH is 443FH. Remember to place the 
address in the Intel format of low byte followed by high byte. 

PROGRAMMING THE 2716 EPROM 

The hardware configuration for the single-voltage 2716 EPROM 
is similar to that for the 2708. Port B is used for the lower address 
bits, and port C bits 0, 1, and 2 are used for the additional addresses. 
This makes a total of 11 addresses, and, therefore, 2048 locations can 
be addressed. Port A is used for data, and it can be programmed to 
write or read depending upon the function desired. Bit 3 of port C 
is used for the chip select (CS/ ) at pin 20. Unlike the 2708, it is not 
necessary to raise the level of this pin to -|- 12 V do to program the 
EPROM. Only one high voltage is required, which is not pulsed but 
is constant. Control of this voltage is obtained from bit 6 of port C, 
which raises pin 21 of the 2716 to 4-25 V dc when programming is to 
start. The actual programming of a word into the EPROM takes 
place using a single TTL-level pulse of 50 ms duration on the pro- 
gramming pin (PROG), which is pin 18 of the 2716. This pulse is 
output from bit 7 of port C. The two remaining bits of port C are 
used to program 2708 EPROMs. Software is used to control the ad- 
dress, data, and pulse width. 

If you study the schematic diagrams (Figs. 4-2 through 4-4), you 
can see that the programming operations for the 2716 and the 2708 
are separate. It is possible to write software that copies the contents 
of one of these PROMs to the other without the need of an inter- 
mediate buffer. 

The sequence used for programming the 2716 is vastly different 
from the procedure used to program the 2708. The 2716 may be pro- 
grammed in a random manner, and it is possible to program a single 
byte in 50 ms, a great improvement over the time required to pro- 
gram a 2708. 

The procedure is as follows: the address is placed on the address 
lines using ports B and C. The program pin voltage of pin ¥,,„ is 
brought to the -f25 V dc level. It is possible to have done this first, 
since the data read operation for the verification of these devices can 
take place with this pin at the -1-25 V dc level. The data is written to 
port A as an output port, and a -f 5 V dc pulse is applied to the PROG 
pin for 50 ms, keeping all other bits unchanged. The -1-25 V may be 
removed, but if more data is to be programmed, it must be present 
until the entire programming sequence is finished. Since the address 
is still on the address lines after a location has been programmed, it 
is possible to verify the programmed data word by changing port A 
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from an output to an input. This is accomplished by using the appro- 
priate command word. The +25 V dc Une does not have to be 
changed to 5 V dc in this read operation. 

This completes the programming process with the data word hav- 
ing been written in the location specified by the address lines. This 
data can be removed only through the application of high-intensity 
ultraviolet light. The erasure process is not as selective as the pro- 
gramming process, and all bits are erased when the EPROM chip 
is subjected to the ultraviolet light. 

The monitor commands used to program the 2716 EPROM are the 
same as those used to program the 2708. However, there is no short- 
cycle lorogram command. After the EPROM programming program 
has been entered in memory, it should be saved using the W com- 
mand. When the P command is executed, a message is displayed 
indicating the EPROM family that the software supports. In this 
case it would indicate that 2716s may be programmed. This is done 
to help you avoid programming the wrong EPROM family. The op- 
tions allow for reading (R), verifying (V), and programming (P) 
of the total EPROM, as well as operating on single bytes. An exam- 
ple of programming a single byte is done using a block specification 
of 1, or 

P 5135T5136 135<ENTER> or, P 5135 1 135<ENTER> 

In this case, the data located in memory location 5135H is trans- 
ferred to the 0135H EPROM location. Verification is automatically 
performed. 

The program also allows programming the IK, 4-5 V dc 2508 or 
2758 EPROMs if a software change is made to apply the program- 
ming TTL pulse to pin 20 instead of pin 18. CAUTION! Damage to 
the 2508 or 2758 results if this change in software is not made. Refer 
to the Intel or Texas Instruments specifications for programming 
these devices. 

The software shown in Appendix G is annotated with the hope 
that you can follow the programming sequence and add or remove 
code as you deem appropriate. The address to be placed in the jump 
vector location 401CH and 401DH is 4400H. Remember to place the 
address in the Intel format of low byte followed by high byte. When 
saving the program on tape, note the starting and ending addresses 
as shown in the listing. 

PROGRAMMING THE 8755 EPROM 

The next EPROM type that the EPROM programmer can support 
is the 8755 device. This integrated circuit contains not only 2K X 8 
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of memory, but also two input/ output ports. The added ports make 
it necessary for the manufacturer to increase the size of the package 
to 40 pins. It also is necessary to share lines to provide all of the 
needed functions. Therefore, the data and low address use a com- 
mon set of pins. This is made possible by the addition of the address- 
latch enable (ALE). (Note that this chip is not directly compatible 
with the Z-80 microprocessor because of the shared lines. It is possi- 
ble to adapt the 8755 so that it could operate on the TRS-80 bus. 
However, it is being assumed that this chip is to be used in a special 
dedicated microprocessor controller which was developed with the 
TRS-80 development system to run on an 8085 system. ) Because of 
the multiplexed address and data bus, the programming of the 
device is complicated slightly. In this adaptation, the 8255 is also 
used to access the input-output control pins of the 8755. More in- 
formation on this chip may be found in the 8085A Cookbook- or in 
application literature on this product. 

The procedure used for the programming of the 8755 EPROM is 
as follows: the low address is placed on the data lines, using PPI 
port A, and is latched into the 8755 through the use of the ALE input, 
pin 11. Port B, bit 0, is used to control this line. All addresses must 
be present when the latching action occurs. This includes the high 
address bits (A8, A9. and A 10) that are obtained from port C bits 
0, 1, and 2. The ALE Hne is high or goes high during the address 
set-up. The input-output memory (lO/M) hne is also latched in at 
this time. This line is brought low using port B, bit 1. A low on the 
lO/M line establishes the device as memory. The two chip-enable 
hues, CEl/PBOG, pin 1 (active low and also functions as the pro- 
gram select when active high ) and CE2, pin 2 ( active high ) , must 
also be asserted at the time the address is set up. Port B, bits 2 and 
3, control the chip select lines. When the above conditions are valid 
(address on address lines, chip selects active, and lO/M low), the 
ALE is brought low, which latches both the address and the memory 
logic states in the 8755. Once this data is latched, the PROG/CEl 
may be activated, changing it from a low to a high, establishing the 
program mode. The PROG pin must remain high until after the 
programming pulse has been applied. Data is placed on the data 
lines of port A. After a delay of 2 fis, Vdd, pin 5 ( driven by port C, 
bit 6 of the 8255), is pulsed from its +5 V dc level to -1-25 V dc for 
50 ms, producing the programming pulse. The 8755, like the 2708, 
requires that the high voltage be pulsed to program the word. How- 
ever, unlike the 2708, only one pulse is required for programming. 
The PROG/CEl input should remain high for an additional 2 /xs 
after a word is programmed. If desired, a verify or read ( RD/ ) 
can be initiated to check the validity of the programmed word. 
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Port A of the peripheral chip must be reversed from output to 
input using the control word. The address is still latched because 
the ALE has remained low during the programming sequence. 
Therefore, all that is required after the data flow is reversed is to 
assert the read line (RD/ ) using port B, bit 7. The data is read from 
the peripheral chip by reading the value from port A. If it is the 
same as the word programmed, verification is complete. As with the 
2716 EPROM, data may be programmed in a random fashion. It is 
also possible to write over data, if only logic Is are to be changed 
to logic Os. The opposite is not possible without a complete erasure 
of the EPROM. 

The software shown in Appendix H is provided to support the 
programming of the 8755 devices. The commands are the same as 
those used in the other EPROM programmers. When the P com- 
mand is executed, a message informs you which device this program 
supports. The commands are read (R), verify (V), and program 
(P). 

The command format for programming the 8755 EPROMs is iden- 
tical to the formats for the 2708 and 2716 EPROMs. The software is 
loaded by any convenient method, then stored on cassette tape. 

The software shown in Appendix H is annotated with the hope 
that you can follow the programming sequence and add or remove 
code as you deem appropriate. The address to be placed in the 
jump vector location 401CH and 401DH is 4400H. Remember to 
place the address in the Intel format of low b5i:e followed by high 
b3^e. When saving the program on tape, note the starting and ending 
addresses as shown in the listing. Remember to include the jump vec- 
tor when originating this tape. Reference should be made to the 
section deahng with the 2708 EPROM. 
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APPENDIX A 



Command Sequence Table 



NOTE: Most <ENTER>s may be substituted with (,) 
quenced. The only exception is the T command. 



(s) and commands may be se- 



Com- 






mand 


Function 


Command and Parameters 


@ 


Fill memory with a constant 


@<LOW ADDRESS> T <HIGH ADDRESS> 




over specified range. 


<CONSTANT> <ENTER> 
@<LOW ADDRESS> <HIGH ADDRESS> 
<BLOCK LENGTH> <CONSTANT> 
<ENTER> 


A 


Display data over specified 


A<LOW ADDRESS> T <HIGH ADDRESS> 




range, ASCII representation 


<CONSTANT> <ENTER> 




of hex data. 


A<LOW ADDRESS> <HIGH ADDRESS> 
<BLOCK LENGTH> <ENTER> 


B 


Execute saved command 
buffer. 


B<ENTER> 


BS 


Save present commands in 
buffer. 


BS<ENTER> 


C 


Clear screen. 


C<ENTER> 


D 


Display data in hexadecimal 


D<LOW ADDRESS> T <HIGH ADDRESS> 




format over specified range. 


<ENTER> 




The address is at the begin- 


D<LOW ADDRESS> <HIGH ADDRESS> 




ning of each line, followed 


<BLOCK LENGTH> <ENTER> 




by the data in it. Up to six- 






teen memory addresses are 






displayed. 




E . 


Execute starting at address 


E<ADDRESS>.<BREAKPOINT> 




specified. Current screen 


<ENTER> 




data is used at start of exe- 


E<ADDRESS>.<BREAKROINT>. 




cution. When a breakpoint is 


<BREAKPOINT> <ENTER> 
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Com- 






mand 


Function 


Command and Parameters 




reached, the data residing in 


E<ENTER> (Current Program Counter is used 




the current screen locations 


for execute address.) 




is transferred to the memory 






locations specified by the 






V(ideo) pointer. 




F 


Find single data byte over 


F<LOW ADDRESS> T <HIGH ADDRESS> 




range specified. Display ad- 


<DATA> <ENTER> 




dress of each occurrence on 


F<LOW ADDRESS> <HIGH ADDRESS> 




crt screen. 


<BLOCK IENGTH> <DATA> <ENTER> 


G 


Execute starting at address 


G<ADDRESS>.<BREAKPOINT> <ENTER> 




specified. The data in the crt 


G<ADDRESS>.<BREAKPOINT>. 




R/W memory is replaced by 


<BREAKPOINT> <ENTER> 




that stored in the memory 


G<ENTER> (Current Program Counter is used 




locations referenced to by 


for execute address.) 




the V(ideo) register. When a 






breakpoint is reached, the 






data in the crt locations is 






stored at the addresses spec- 






ified by V. 




H 


Hexadecimal sum and dif- 
ference of two values. Value 
2 is added to value 1; then 
value 2 is subtracted from 
value I . 


H<VALUE1> <VALUE2> <ENTER> 


1 


Insert object code or data 


l<ADDRESS> <DATA> <DATA>. . . 




into memory starting at ad- 


<DATA><ENTER> 




dress specified. Address may 


1<ADDRESS> <DATA>. . .<DATA> 




be changed using the /. The 


<ADDRESS>/ <DATA>. . .<DATA> 




buffer is only 255 bytes 


<ENTER> 




long, and w^hen it is full no 






further data is accepted. De- 






posit is accomplished by 






pressing <ENTER>. 




J 


Not used. 




K 


Not used. 




L 


Hard copy flag toggle for 
listing on printer. (Hard copy 
driver program must be 
loaded in R/W memory. See 
text.) 


L<ENTER> 


M 


Move the contents of mem- 


M<LOW ADDRESS> T <HIGH ADDRESS> 




ory contained in locations 


<DESTINATION ADDRESS> <ENTER> 




specified to new locations 


M<LOW ADDRESS> <HIGH ADDRESS> 




starting at specified destina- 


<LENGTH> <DESTINATION> <ENTER> 




tion address. 




N 


Input data from input port 


N<PORT NUMBER> <ENTER> 




or range of ports. 


N<PORT NUMBER> T 

<PORT NUMBER END> <ENTER> 
N<PORT NUMBER> <NUMBER OF PORTS> 

<ENTER> 
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Com- 






mand 


Function 


Command and Parameters 


O 


Output data to port specified. 


0<PORT NUMBER> <DATA> <ENTER> 


P 


Program EPROMs. (it is re- 
quired that this option is 
available in R/W memory. 
See text.) 


P<ENTER> 


Q 


Search for two-byte word in 


Q<LOW ADDRESS> T <HIGH ADDRESS> 




Intel format, low byte fol- 


<DATA> <ENTER> 




lowed by high byte. Each 


Q<LOW ADDRESS> <HIGH ADDRESS> 




occurrence is displayed. 


<BLOCK LENGTH> <DATA> <ENTER> 


R 


Read cassette tape using 


R<ENTER> 




TRS-80 500 bits per second 


R<BIAS> <ENTER> 




format. A bias may be en- 






tered, and the value of this 






bias is used to offset the 






placement of the data in 






memory from that specified 






in the format. 




S 


An alternate form of substi- 


S<ADDRESS><ENTER><DATA><ENTER> 




tuting object code or data 


<SPACE> <ADDRESS>/ <DATA> 




into R/W memory. This com- 


<ENTER> <DATA> <RUBOUT> 




mand is interactive. A double 


<REPLACEMENT DATA> <ENTER> 




<ENTER> returns to buffer 


<ENTER> 




sequence execution. 




T 


Transfer data in video stor- 
age to screen to show the 
state of the crt when a 
breakpoint was encountered. 
The V register must point to 
the starting location of the 
storage address. If V is 
3C00H (default value), then 
the data is stored in the 
video R/W memory and will 
be scrolled. This command is 
useful when program devel- 
opment uses video screen lo- 
cations for i/o. 


T<ENTER> 


U 


User assignable. (Option must 
be loaded into R/W memory. 
See text.) 


U<ENTER> 


V 


Verify locations specified in 


V<LOW ADDRESS> T <HIGH ADDRESS> 




first locations specified with 


<DESTINATION ADDRESS> <ENTER> 




the data in locations starting 


V<LOW ADDRESS> <HIGH ADDRESS> 




at the address in the desti- 


<LENGTH> <DESTINATION> <ENTER> 




nation field. 




W 


Write a tape cassette using 


W<START ADDRESS>T<END ADDRESS> 




Radio Shack format. Name is 


<EXECUTE ADDRESS> «NAME» 




optional. 


<ENTER> 
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Com- 






mand 


Function 


Command and Parameters 






W<START ADDRESS> <LENGTH> 






<EXECUTE ADDRESS> «NAAAE» 






<ENTER> 


X 


Examine and/or modify reg- 


X<ENTER> (All registers displayed, no modifi- 




isters. Valid register names 


cations.) 




are as follows: 


X<REGISTER> <ENTER> (Only specified reg- 




P Program counter 


ister displayed.) 




S Stack Pointer 


X<REGISTER> <DATA> <ENTER> (Data re- 




X IX Register Y lY Register 


places former contents.) 




N Interrupt Flag 1 set not 

set 
1 Interrupt Vector 










V Video screen storage 






pointer 






A, B, C, D, H, L, F Registers 






A', B', C, D', E', H', L', F' 






Alternate Registers 




Y 


Not used. 




Z 


Single-step function. Hard- 


Z<ENTER> (Current program counter is used 




ware must be installed for 


for start address.) 




this command to function. 


Z<EXECUTE START ADDRESS><ENTER> 
Z.<BREAKPOINT><ENTER> (In case command 

executed is a disable interrupt, the breakpoint 

is used to return to monitor.) 
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APPENDIX C 



Hardware and Software 
Supplier 



An EPROM chip containing the FROLIC™ monitor is available 
for both the Model I and Model III TRS-80 computers. Due to dif- 
ferences in the computer circuits, the software is not exactly equiva- 
lent. However, the monitor functions are the same. 

The source program is also available for both computers on a cas- 
sette tape. The monitor may be used with 16K, 32K, or 48K of read/ 
write memory. A floppy disk containing the source program and the 
object program is available for computers with 16K, 32K, or 48K of 
read/ write memory. 

The electronic components, printed circuit boards, and other sup- 
plies for the single-step interface, the EPROM programmer, and 
the serial i/o interface are also available. Each kit or assembled unit 
is supplied with a cassette tape that contains the source program(s) 
for the interface. These program tapes may be purchased separately. 

All of the hardware and software is available from: 

Frolic Devices 
P. O. Box 772 
Bloomfield, CT 06002 

A stamped, self -addressed envelope may be sent to Frolic Devices 
for current prices and delivery information. 
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APPENDIX D 



Source Listing for 

FROLIC Monitor for the 

Model I TRS-80 
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00010 












00020 




MODEL I TRS-80 DEVELOPMENT SYSTEMS 






00030 




DISK NAME MODI/ASH 






00040 




MODEL I FROLIC MONITOR 






00050 








4012 




00060 RSTLOC 


EQU 4012H 




OOFF 




00070 RST 


EQU OFFH 




4000 




00080 REF 


EQU 04000H : 


START OF RAM 


4080 




00090 BUFFER 


EQU REF+80H 




4180 




00100 TEM 


EQU REF+180H ; 


SAVED BUFFER AREA 


4040 




00110 REFl 


EQU REF+40H 




4040 




00120 CURSOR 


EQU REFl 




4042 




00130 SSFLAG 


EQU REFl+2 ; 


SINGLE STEP FLAG 


4043 




00140 COUNT 


EQU REF1+3H 




4044 




00150 CHARK 


EQU REF1+4H 




4045 




00160 BPNO 


EQU HEF1+5H 




4048 




00170 BPOINT 


EQU REF1+8H : 


BUFFER POINTER 


404A 




00180 PRNTFG 


EQU REFl+OAH 




404B 




00190 PRIHF 


EQU REFl+OBH 




4024 




00200 REF2 


EQU REF+24H 




4024 




00210 SSTACK 


EQU REF 2 




4026 




00220 BOTMS 


EQU SSTACK+2H 




403C 




00230 PCSAVE 


EQU REF2+18H 




403A 




00240 HLSAVE 


EQU PCSAVE-2 




4080 




00250 BREAKS 


EQU BUFFER : 


JUST BELOW BUFFER 


3C00 




00260 VIDEO 


EQU 3C00H 




4047 




00270 OLD 


EQU REF+47H 




4046 




00280 UCFLAG 


EQU REF+46H 




403E 




00290 SCREEN 


EQU PCSAVE+2H 




4018 




00300 TTYP 


EQU REF+18H 




401B 




00310 PROM 


EQU REF+IBH 




401E 




00320 USER 


EQU REF+IEH 




4300 




00330 USERSP 


EQU REF+300H 


USER STACK POINTER 


42C0 




00340 HONSP 


EQU USERSP-40H 


MONITOR STACKPOINTER 


42A0 




00350 JHP 
00360 : 


EQU HONSP-20H 


TOP OF MONITOR STACK 


0000 




00370 
00380 : 


ORG OOOOOH 




0000 


AF 


00390 


XOR A 


CLEAR AC 


0001 


D3PF 


00400 


OUT (OFFH) ,A 


LOWER CASE AND CASSETTE OFF 


0003 


210040 


00410 


LD HL.REF 


SYSTEM RAM 


0006 


1803 


00420 


JR SI 


BY PASS RESTARTS 


0008 


C30040 


00430 


JP 4000H 


RST 1 


ODOB 


010003 


00440 SI 


LD BC,0300H 


CLEAR 1ST 3 PAGES 


OOOE 


1803 


00450 


JR S2 




0010 


C30340 


00460 


JP 4003H 


•RST 2 


0013 


77 


00470 S2 


LD (HL),A 




0014 


ED56 


00480 


IM 1 


SET INTERRUPT MODE 1 


0016 


1803 


00490 


JR S3 




0018 


C30640 


00500 


JP 4006H 


;RST 3 


OOIB 


EDAl 


00510 S3 


CPI 




OOID 


F3 


00520 


DI 


•DISABLE INTERRUPTS 


OOIE 


1803 


00530 


JR S4 




0020 


C30940 


00540 


JP 4009H 


:RST 4 


0023 


E22B00 


00550 S4 


JP PO,CON 


: CONTINUE INITIALIZATION 


0026 


18BB 


00560 


JR S2 


: CONTINUE TO CLEAR RAM 


0028 


C30C40 


00570 




JP 400CH 


;RST 5 
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002B 
002D 
002F 
0030 
0033 
0036 
0038 
Q03B 
003C 
003D 
003E 
003F 
0040 
0041 
0042 
0043 
0044 
004B 
004C 
004E 
0051 
0054 
0057 
005A 
005D 
0061 
0063 



0066 
0069 
006C 
006F 
0072 
0073 
0076 
0078 
0079 
007B 
007C 
007D 
007E 
0080 
0083 
0086 
0087 
00 8A 
OOBD 
008F 
0091 
0094 



3EC9 

1804 

00 

C30F40 

310043 

1814 

C31240 

OD 

OC 

01 

OB 

OA 

08 

09 

20 

OD 

46 

01 

0E09 

211840 

CDBB03 

CDFEOl 

21003C 

223E40 

ED732440 

3EA0 

324440 



31BE42 

CD07 01 

CD8A01 

218040 

E5 

CD2701 

362C 

23 

3601 

El 

77 

E5 

FDEl 

31C042 

210403 

E5 

CD9E01 

CDEF02 

28FB 

D640 

DA0C03 

212D03 



0097 FE5A 
0099 D20C03 
009C 87 
009D 5F 



00580 
00590 
00600 
00610 
00620 
00630 
00640 
00650 
00660 
00670 
00680 
00690 
00700 
00710 
00720 
00730 
00740 
00750 
00760 
00770 
00780 
00790 
00800 
00810 
00820 
00830 
00840 
00850 
00860 
00870 
00880 
00890 
00900 
00910 
00920 
00930 
00940 
00950 
00960 
00970 
00980 
00990 
01000 
01010 
01020 
01030 
01040 
01050 
01060 
01070 
01080 
01090 
01100 
OHIO 
01120 
01130 
01140 



CON 

CONl 
TABLE 



SIGNOM 
C0N2 



COHAND 
COMl 



LD A,0C9H 

JR CONl 

NOP 

JP 400FH 

LD SPrUSERSP 

JR C0N2 

JP 4012H 

DEFB ODH 

DEFB OCH 

DEFB OIH 

DEFB OBH 

DEFB OAH 

DEFB 08H 

DEFB 09H 

DEFB 20H 

DEFB ODH 

DEFH 'FROLIC:' 

DEFB OIH 

LD C,09 

LD HL.TTYP 

CALL FILLl 

CALL CLEARS 

LD HL,3CO0H 

LD ( SCREEN ),HL 

LD (SSTACK),SP 

LD A,0A0H 

LD (CHARK),A 



;FILL 

:RST 6 

;SET USER STACK 



:WILL INITIALIZE CURSOR 

;END OF MESSAGE 

;LOAD RETURNS IN USER RAM 

; START OF FILL 

: CLEAR SCREEN ONLY ON POWER UP 



: INITIALIZE USER STACK 
: CURSOR MARK 
: PLACE IN RAM 



RESET START OF PROGRAM 



LD SP,M0NSP-2 

CALL CLRBP 

CALL PHSGl 

LD HL, BUFFER 

PUSH HL 

CALL BUF 

LD (HL),2CH 

INC HL 

LD (HL),01H 

POP HL 

LD (HL) ,A 

PUSH HL 

POP lY 

LD SP,MONSP 

LD HL.CONTIN 

PUSH HL 

CALL NEWLIN 

CALL GET 

JR Z,CD 

SUB '8' 

JP C, ERROR 

LD HL,COHTAB 

CP 'Z' 

JP NC. ERROR 
ADD A, A 
LD E,A 



INITIALIZE STACK 

CLEAR BREAKPOINTS 

FROLIC: 

BUFFER BEGINNING 

SAVE FOR LATER 

BUFFER AVAILABLE FOR OTHERS 

DELIMITER 

BREAK AT END OF BUFFER 

GET BUFFER BEGINNING 

PUT ODH, ERRORS WILL DO LINEFEED 

BUFFER POINTER FOR MONITOR 

NECESSARY FOR COMMANDS 

RETURN ADDRESS ON STACK 

PUT RETURN ADDRESS ON STACK 

SAVES DOING IT IN COMMAND 

GET WILL GET FIRST NON ZERO CHAR 

IGNORE LEADING SPACES 

BORROW IF < 8 

A 00 IP ' 

POINT TO COMMAND TABLE 

A BORROW IS ALWAYS GENERATED 

BORROW VALID 8 THRU Z 

DOUBLE NUMBER 
FOR DOUBLE ADD 
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009E 1600 

OOAO 19 

OOAl 5E 

00A2 23 

00A3 56 

00A4 EB 

OCAS E9 



00A6 
00A7 
OOAS 
OOAB 
OOAC 
OOAF 
OOBO 
00B3 
00B4 
00B7 
00B8 
OOBB 
ODBC 
OOBD 
OOBE 
OOCl 
00C2 
00C4 
00C5 
0OC8 
OOCB 
OOCC 
OOCF 
OODO 
ODDl 
00D2 
00D3 
00D4 
00D5 
00D7 
00D8 
OODA 
OODD 
OODE 
OODF 
OOEl 
00E3 
00E6 
00E9 
ODED 
OOEP 
00F3 
00F4 
OOFS 
OOFS 
OOFB 
OOFE 
0101 
0104 



E3 

2B 

223C40 

El 

223A40 

F5 

210200 

39 

222440 

Fl 

313A40 

D5 

C5 

F5 

3A4240 

B7 

280B 

AF 

324240 

2A3C40 

23 

223C40 

D9 

E5 

D5 

C5 

08 

F5 

ED57 

67 

2E00 

E2DE00 

2C 

E5 

FDE5 

DDES 

21003C 

010004 

ED5B3E40 

EDBO 

FD2A4840 

3B 

3B 

CD0701 

31BE42 

CD8605 

2A3C40 

010500 

C3A703 



01150 

01160 

01170 

01180 

01190 

01200 

01210 

01220 

01230 RSAVE 

01240 

01250 

01260 

01270 

01280 

01290 

01300 

01310 

01320 

01330 

01340 

01350 

01360 

01370 

01380 

01390 

01400 

01410 

01420 

01430 

01440 

01450 EXX 

01460 

01470 

01480 

01490 

01500 

01510 

01520 

01530 

01S40 

OlSSO 

01560 SAVEl 

01570 

01580 

01590 

01600 

01610 

01620 

01630 

01640 

01650 

01660 

01670 

01680 

01690 

01700 

01710 



to D,OH 
ADD HL,DE 
LD E, (HL) 
INC HL 
LD D, (HL) 
EX DE,HL 
JP (KL) 

EX (SP) ,HL 

DEC HL 

LD {PCSAVE),HL 

POP HL 

LD (HLSAVE) .HL 

PUSH AF 

LD HL,0002H 

ADD HL.SP 

LD (SSTACK) ,HL 

POP AF 

LD SP, HLSAVE 

PUSH DE 

PUSH BC 

PUSH AF 

LD A, (SSFLAG) 

OR A 

JR Z,EXX 

XOR A 

LD (SSFLAG) ,A 

LD HL,(PCSAVE) 

INC HL 

LD (PCSAVE),HL 

EXX 

PUSH HL 

PUSH DE 

PUSH BC 

EX AF.AF' 

PUSH AF 

LD A, I 

LD H.A 

LD L,00H 

JP PO, SAVEl 

INC L 

POSH HL 

PUSH lY 

PUSH IX 

LD HL,3C00H 

LD BC,0400H 

LD DE, (SCREEN) 

LDIR 

LD lY, (BPOINT) 

DEC SP 

DEC SP 

CALL CLRBP 

LD SP,H0NSP-2 

CALL XALL 

LD HL,(PCSAVE) 

LD BCOSH 

JP DISPl 



; BE AT A PAGE BOUNDARY 

;ADD WITH CARRY SET FROM COMPARE 

;GET LOW BYTE 

;GET HIGH BYTE 

:JUHP TO ADDRESS 

; EXECUTE REST OF COMMAND 

GET PROGRAM COUNTER 

ADJUST 

AND SAVE 

SAVE HL AND ADJUST STACKPOINTER 

SAVE FLAGS IN FORMER HL 

ADJUST FOR RST OR INT 

GET SYSTEM USER STACK 

SYSTEM STACK STORAGE 

GET FLAGS BACK 

START OF REGISTER SAVE 



FLAGS ON STACK 

SINGLE STEP? 

TEST 

NO SINGLE STEP IF ZERO 

NOH ZERO 

CORRECT FLAG 

GET PC COUNTER 

ADJUST 

REPLACE 



GET INT VECTOR AND IFF FLAG 

STORE IN H 

INITIALIZE L 

IF PARITY FLAG NOT SET IFF INT D 

IFF SET INDICATE WITH NON ZERO 

SAVE INT VECTOR AND INT SET FLAG 



: START OF SCREEN TRANSFERRED 

;AREA STARTING AT SCREEN 

;GET LAST POSITION IN BUFFER 
IHUST NOT DESTROY STACK 

CLEAR BREAK POINTS 
CORRECT STACK 
DISPLAY REGISTERS 
GET PROGRAM COUNTER 
NUMBER OF BYTES 
DISPLAY 
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0107 


210000 


01720 


CLRBP 


LD HL.OOH : 


OlOA 


3A454Q 


01730 




LD A, (BPNO) ; 


OlOD 


B7 


01740 




OR A : 


OlOE 


6F 


01750 




LD L,A 


OlOF 


C8 


01760 




RET Z ; 


0110 


CI 


01770 




POP BC ; 


0111 


29 


01780 




ADD HL.HL : 


0112 


29 


01790 




ADD HL,HL ; 


0113 


EB 


01800 




EX DE,HL 


0114 


218040 


01810 




LD HL, BREAKS 


0117 


ED52 


01820 




SBC HL,DE : 


0119 


F9 


01830 




LD SP,HL ; 


OllA 


C5 


01840 




PUSH BC 


OllB 


El 


01850 




POP HL ; 


one 


47 


01860 




LD B,A ; 


OllD 


Fl 


01870 


CLRBPl 


POP AF 


QUE 


Dl 


01880 




POP DE 


OllF 


12 


01890 




LD (DE) ,A 


0120 


lOPB 


01900 




DJNZ CLRBPl 


0122 


AF 


01910 




XOR A 


0123 


324540 


01920 




LD (BPNO) .A ; 


0126 


E9 


01930 
01940 
01950 
01960 




JP (HL) ; 
;FILL BUFFER WITH 


0127 


3E40 


01970 


BUF 


LD A,40H ; 


0129 


324640 


01980 




LD (UCFLAG) ,A : 


012C 


23 


01990 


BUFO 


INC HL ; 


012D 


0601 


02000 




LD B.OIH ; 


012F 


CD6E02 


02010 


BUFl 


CALL GBYTE : 


0132 


FEOl 


02020 




CP OIH ; 


0134 


CA6600 


02030 




JP Z.RSTART : 


0137 


FEOD 


02040 




CP ODH ; 


0139 


C8 


02050 




RET Z ; 


013A 


FEOC 


02060 




CP OCH ; 


013C 


2812 


02070 




JR Z.PCH ; 


013E 


FE08 


02080 


DELETE 


CP OSH : 


0140 


2010 


02090 




JR NZ, PCHAR : 


0142 


3E01 


02100 


DLT 


LD A.OIH ; 


0144 


B8 


02110 




CP B : 


0145 


28E8 


02120 




JR Z.BUFl : 


0147 


2B 


02130 


DLTE 


DEC HL ; 


0148 


05 


02140 


DLTEl 


DEC B ; 


0149 


3E08 


02150 




LD A,08H 


014B 


CDB201 


02160 




CALL CRT ; 


014E 


18DF 


02170 




JR BUFl : 


0150 


3E43 


02180 


PCH 


LD A , ' C ' ; 


0152 


04 


02190 


PCHAR 


INC B ; 


0153 


28F2 


02200 




JR Z.DLTE : 


0155 


77 


02210 




LD (HL) ,A 


0156 


CDB201 


02220 




CALL CRT : 


0159 


23 


02230 




INC HL ; 


015A 


18D3 


02240 




JR BUFl : 






02250 












02260 






FOLLOWING ARE PR 






02270 






CONDITIONING FOR 






02280 









CLEAR 

LD HL WITH NO OF BPOINTS 

SET ZERO FLAG 

STORE JUST IN CASE 

IF NO BREAKPOINTS GO TO COIiMAND 

GET RETURN ADDRESS 

DOUBLE VALUE IN L 

AND AGAIN 



BORROW CLEAR DECREMENT STACK 
NEW STACK POSITION TOP 



READY FOR F.ETURN 

SHOULD STILL HAVE NUMBER 



PUT ZERO IN BPNO 

HL HL HAS RETURN ADDRESS 



IF ENTERED HERE ONLY UPPER CASE 

40H IS UPPER FLAG, 60H FOR LC 

LEAVE ROOM FOR BUFFER COUNT 

ROOM FOR COUNT. COMMA. AND OIH 

GET CHARACTER RETURN WITH DATA 

ESCAPE FROM BUFFER ENTRY 

RETURN TO COMMAND. SP IS OK 

CARRIAGE RETURN 

RETURN TO CALLING ROUTINE 

CLEAR SCREEN 

CHANGE DATA TO K COHMAND 

BACKSPACE? 

NO INSERT CHAR INTO BUFFER 

BEGINNING 

IS IT 

CAN'T GO BACK FURTHER 

DECREMENT BUFFER 

AND COUNT 

REMOVE FROM SCREEN 

GET NEXT CHAR 

CLEAR SCREEN 

IS THERE ROOM? 

NO SO DO AUTOMATIC 08H 

LOAD IN BUFFER AND DISPLAY 
NEXT POSITION IN BUFFER 
GET NEXT CHARACTER 
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015C 


CDA201 


02290 


SPCHL 


CALL SPACE 


; PRINT A SPACE FOLLOWED BY 


015F 


7E 


02300 


PPHL 


LD A, (HL) 


;THE NUMBER LOCATED AT (HLl 


0160 


CD6301 


02310 


PHEX 


CALL PHEXH 


;TWO NIBBLES MUST BE OUTPUT 


0163 


OF 


02320 


PHEXH 


RRCA 


;GET HIGH HEX VALUE 


0164 


OF 


02330 




RRCA 




0165 


OF 


02340 




RRCA 




0166 


OF 


02350 




RRCA 


;SWAP COMPLETE 


0167 


F5 


02360 


PHEXL 


PUSH AF 


;GET LOW HEX VALUE 


0168 


E60F 


02370 




AND OFH 


:MASK 


016A 


FEOA 


02380 




CP OAH 


; GREATER THAN 9 


016C 


3007 


02390 




JR NC, ADJUST 


;THEN NO CARRY 


016E 


F630 


02400 




OR 30H 


;NOW ASCII FOR 0-9 


0170 


CDA401 


02410 


PHEXl 


CALL PRNT 


; OUTPUT 


0173 


Fl 


02420 




POP AF 


;GET AND ADJUST SP 


0174 


C9 


02430 




RET 




0175 


C637 


02440 


ADJUST 


ADD A,37H 


lADJUST FOR ALPHABETIC 


0177 


18F7 


02450 
02460 




JR PHEXl 








02470 




•PRINTS NUMBER 


IN HL REGISTER AS ADDRESS 






02480 








0179 


7C 


02490 


PNHL 


LD A,H 


: PRINT H FIRST 


017A 


CD6001 


02500 




CALL PHEX 




017D 


7D 


02510 




LD A,L 


;NOW L 


017E 


IBEO 


02520 




JR PHEX 


; RETURNS FROM CRT PROGRAM 


0180 


CD9E01 


02530 


ADDR 


CALL NEWLIN 


;D0 CR AND LINE FEED 


0183 


CD7901 


02540 


ADDRl 


CALL PNHL 


; PRINTS HL WHICH IS ADDRESS 


0186 


3E3A 


02550 


ADDR2 


LD A , ' : ' 


; DELIMITER 


0188 


181A 


02560 
02570 
02580 
02590 




JR PRNT 

; PRINT MESSAGE 




018A 


214300 


02600 


PMSGl 


LD HL,SIGNON 


; FROLIC: 


018D 


7E 


02610 


PHSG 


LD A, (HL) 


;GET DATA 


018E 


FEOl 


02620 




CP OIH 


;END OF MESSAGE MARK 


0190 


C8 


02630 




RET Z 


; RETURNS FROM MESSAGES VIA BREAK 


0191 


CDB201 


02640 




CALL CRT 




0194 


23 


02650 




INC HL 


iNEXT DATA 


0195 


18F6 


02660 
02670 




JR PMSG 








02680 




;SHIPT DATA THROUGH HL PAIR 






02690 








0197 


29 


02700 


LDHL 


ADD HL,HL 


ISHIFT 


0198 


29 


02710 




ADD HL,HL 




0199 


29 


02720 




ADD HL.HL 




019A 


29 


02730 




ADD HL,HL 




019B 


B5 


02740 




OR L 


;0R AC IN SHIFT PATTERN 


019C 


6F 


02750 




LD L,A 


; REPLACE L 


019D 


C9 


02760 
02770 




RET 








02780 




; PRINTS DATA IN 


A TO PRINT DEVICE 






02790 








019E 


3E0D 


02800 


NEWLIM 


LD A,ODH 


;LINE FEED 


OlAO 


1802 


02810 




JR PRNT 


:WANT TO BREAK ON NEW LINES 


01A2 


3E20 


02820 


SPACE 


LD A,20H 


; SPACE ADJUST 


01A4 


F5 


02830 


PRNT 


PUSH AF 


: SAVE 


01A5 


CD7E02 


02840 


PRNTl 


CALL CHKIN 


;HAS BREAK OR SPACE 


01A8 


FEOl 


02650 




CP OIH 


;BEEN PRESSED 
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OlAA CA6600 


02860 




JP Z,RSTART 


OlAD FE20 


02870 




CP 20H 


OlAF 28F4 


02880 




JR Z.PRNTl 


OlBl Fl 


02890 
02900 




POP AF 




02910 




:CRT DISPLAY 




02920 




: 


01B2 D9 


02930 


CRT 


EXX 


01B3 F5 


02940 




PUSH AF 


01B4 DBFF 


02950 




IN A, (OFFH) 


01B6 E640 


02960 




AND 40 H 


01B8 0600 


02970 




LD B,00H 


OIBA 2001 


02980 




JR NZ.CRTl 


OIBC 04 


02990 




IMC B 


OIBD Fl 


03000 


CRTl 


POP AF 


OIBE FS 


03010 




PUSH AF 


OIBF 2A4040 


03020 




LD HL, (CURSOR) 


01C2 3620 


03030 




LD (HL),20H 


01C4 FEOD 


03040 




CP ODH 


alC6 280D 


03050 




JR Z, LINEF 


01C8 FE08 


03060 




CP 08H 


OICA 281B 


03070 




JR Z,BKSP 


OICC 77 


03080 




LD (HL) ,A 


OICD 23 


03090 




INC HL 


OICE 1001 


03100 




DJNZ FULSCN 


OlDO 23 


03110 




INC HL 


OlDl CB74 


03120 


FULSCN 


BIT 6,H 


01D3 2816 


03130 




JR Z,buT2 


OlDS 01C003 


03140 


LINEF 


LD BCOBCOH 


01D8 11003C 


03150 




LD DE, VIDEO 


OlDB 21403C 


03160 




LD HL,V1DE0+64D 


OlDE EDBO 


03170 




LOIR 


OlEO EB 


03180 




EX DE.HL 


OlEl CD0302 


03190 




CALL CLEAR 


01E4 21C13F 


03200 




LD HL,VIDEO+961D 


01E7 2B 


03210 


BKSP 


DEC HL 


01E8 1001 


03220 




DJNZ 0UT2 


OlEA 2B 


03230 




DEC HL 


OIBB 224040 


03240 


0UT2 


LD (CURSOR) ,HL 


OlEE 3A4440 


03250 




LD A. (CMARK) 


OlFl 77 


03260 




LD (HL) ,A 


01F2 Fl 


03270 




POP AF 


01F3 4F 


03280 




LD C,A 


aiF4 3A4A40 


03290 




LD A, (PRNTFG) 


01F7 B7 


03300 




OR A 


01F8 C41840 


03310 




CALL NZ.TTYP 


OlFB 79 


03320 




LD A.C 


OlFC D9 


03330 




EXX 


OlFD C9 


03340 




RET 


OlFE 210a3C 


03350 


CLEARS 


LD HL, VIDEO 


0201 FD23 


03360 




INC lY 


0203 CB74 


03370 


CLEAR 


BIT 6,H 


0205 CO 


03380 




RET NZ 


0206 3620 


03390 




LD (HL),20H 


0208 23 


03400 




INC HL 


0209 18F8 


03410 
03420 




JR CLEAR 



iCONTINUE WITH BUFFER 



YES, WAIT FOR RELEASE 
FALL INTO CRT DISPLAY 



CRT OUTPUT OF DATA IN A 

CHECK FOR LARGE GRAPHICS 
ZERO LARGE, NZ REGULAR 
FLAG FOR LARGE CHARACTERS 

FLAG FOR REGULAR CHARACTERS 
GET CHARACTER BACK 
REPLACE ON STACK 

REMOVE CURSOR 
CARRIAGE RETURN 

BACKSPACE 

PLACE CHARACTER ON SCREEN 
ADVANCE CURSOR 



■OFF PAGE? 

:1024-64 MEMORY BYTES 

:ONE LINE FROM PAGE TOP 

: CLEAR LAST LINE 
: CLEAR LAST LINE 

; BEGIN OF LAST LINE 



MONITOR OR USER? 

CURSOR MARK 

GET DATA FROM STACK 

SAVE IN C REGISTER 

GET HARD COPY FLAG 

IF NON ZERO CALL PRINT 

IN RAM A JUMP TO USER ROUTINE 

RESTORE DATA TO A 

REPLACE THOSE REGISTERS 



CORRECT BUFFER 

FINISHED 

WHEN THIS BIT GOES ONE 

SPACE ON SCREEN 

NEXT 

CONTINUE WITH CLEAR 
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03430 




IFILL ROUTI 






03440 






020B 


CD1402 


03450 


G3N 


CALL G2M 


020E 


EB 


03460 




EX DE.HL 


020F 


CD4302 


03470 




CALL GHL 


0212 


EB 


03480 




EX DE,HL 


0213 


C9 


03490 




RET 


0214 


CD4302 


03500 


G2N 


CALL GHL 


0217 


EB 


03510 




EX DE,HL 


0218 


CDF102 


03520 




CALL GETl 


021B 


3821 


03530 




JR C,G2H3 


021D 


CCEF02 


03540 


G2N0 


CALL 2, GET 


0220 


28FB 


03550 




JH Z,G2N0 


0222 


FE54 


03560 




CP 'T' 


0224 


280D 


03570 




JR Z,G2N1 


0226 


FD2B 


03580 




DEC lY 


0228 


CDF102 


03590 




CALL GETl 


022B 


C20C03 


03600 




JP NZ, ERROR 


022E 


CD4302 


03610 




CALL GHL 


0231 


1807 


03620 




JR G2N2 


0233 


CD4302 


03630 


G2N1 


CALL GHL 


0236 


3F 


03640 




CCF 


0237 


ED52 


03650 




SBC HL.DE 


0239 


23 


03660 




INC HL 


Q23A 


44 


03670 


G2N2 


LD B,H 


023B 


4D 


03680 




LD C,L 


023C 


EB 


03690 




EX DE,HL 


a23D 


C9 


03700 




RET 


023E 


214000 


03710 


G2N3 


LD HL,40H 


0241 


18F7 


03720 
03730 
03740 
03750 




JR G2N2 
:GET VALID 


0243 


210000 


03760 


GHL 


LD HL,OOOOH 


0246 


CDEF02 


03770 


GHLO 


CALL GET 


0249 


28FB 


03780 




JR Z,GHLO 


024B 


CD5D02 


03790 




CALL VALHEX 


024E 


DAaC03 


03800 




JP C, ERROR 


0251 


CD9701 


03810 


GHLl 


CALL LDHL 


0254 


CDEF02 


03820 




CALL GET 


0257 


CD5D02 


03830 




CALL VALHEX 


025A 


30F5 


03840 




JR NCGHLl 


025C 


C9 


03850 
03860 
03870 
03880 




RET 

; CHECK IF V 


025D 


C6D0 


03890 


VALHEX 


ADD A,ODOH 


025P 


3F 


03900 




CCP 


0260 


D8 


03910 




RET C 


0261 


FEOA 


03920 




CP OAH 


0263 


3F 


03930 




CCF 


0264 


DO 


03940 




RET NC 


0265 


C6F9 


03950 




ADD A,0P9H 


0267 


FEOA 


03960 




CP OAH 


0269 


08 


03970 




RET C 


026A 


PEIO 


03980 




CP lOH 


026C 


3P 


03990 




CCF 



GET TWO NUMBERS HL AND BC 

SAVE HL VALUE IN DE 

GET 3RD ARGUMENT 

THIS GOES IN DE REGISTER 

WITH HL START ADDRESS 

GET 2 NUMBERS FIRST FOR HL 

GET LAST DATA IN BUFFER 

FOR LONGEST INSTRUCTION 

EITHER COULD BE T 

SKIP SPACES 

THROUGH TILL LAST ADDRESS 

GO COMPUTE BLOCK LENGTH 

ADJUST POINTER 

LAST IN BUFFER 

ONLY VALID DELIMITERS 

GET BLOCK LENGTH 

GO STORE IN HL 

END ADDRESS MUST COMPUTE 

CLEAR FLAG 

:NEED ONE MORE 

; STORE LENGTH IN BC 

;PUT START ADDRESS BACK 

[MINIMUM LENGTH 40H 
; STORE IN BC 



: INITIALIZE TO ZERO 

SKIP SPACES 

CHECK FOR VALIDITY 

THIS MUST CLEAR BREAK POINTS 

SHIFT INTO HL PAIR 



;AND RETURN TO CALLING PROGRAM 



IF BETWEEN 30 AND 39 

AND 41 AND 47 CARRY GENERATED 

RETURN NOT VALID FLAG 

IF LESS THAN 10 VALID 

VALID RETURN IS NO CARRY 

BETWEEN AND 9 AND VALID 

IF BETWEEN 17H AND 22H 

THIS WILL FLAG 

ERROR THOSE PEW 

;IP OVER OPH NO CARRY 
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026E 
026F 
0272 
0275 
0276 
0278 
0279 
a27A 
027C 
027D 
027E 
0281 
0282 
0283 
0284 
0287 
0288 
028A 
028C 
028P 
0290 
0292 
0293 



0294 
0297 
029A 
029B 
029C 
029E 
02A0 
02A1 
02A4 
02A5 
02A6 
02A7 
02A9 
02AA 
02 AC 
02AE 
02B0 
02B1 
02B2 
02B3 
02B4 
02B5 
02B6 
02B9 
02BA 
02BC 
02BD 



E5 

CD7E02 

214740 

BE 

28F7 

77 

B7 

28F3 

El 

C9 

3A7P38 

B7 

C8 

D9 

CD9402 

57 

0600 

lOPE 

CD9402 

BA 

20F2 

D9 

C9 



010000 

210138 

7E 

B7 

2008 

CB25 

03 

F29A02 

AP 

C9 

IF 

3803 

04 

18FA 

CB75 

2037 

79 

07 

07 

07 

BO 

4P 

3A8038 

47 

3E08 

BD 

380C 



04000 
04010 
04020 
04030 
04040 
04050 
04060 
04070 
04080 
04090 
0410O 
04110 
04120 
04130 
04140 
04150 
04160 
04170 
04180 
04190 
04200 
04210 
04220 
04230 
04240 
04250 
04260 
04270 
04280 
04290 
04300 
04310 
04320 
04330 
04340 
04350 
04360 
04370 
04380 
04390 
04400 
04410 
04420 
04430 
04440 
04450 
04460 
04470 
04480 
04490 
04500 
04510 
04520 
04530 
04540 
04550 
04560 



KYDl 
NEXT 



RET ; RETURN WITH PROPER FLAG 

;GET CHARACTERS 



PUSH HL 

CALL CHKIN 

LD HL,OLD 

CP (HL) 

JR Z,GBYTE+1 

LD (HL) ,A 

OR A 

JR Z.GBYTE+1 

POP HL 

RET 

LD A, (387FH) 

OR A 

RET Z 

EXX 

CALL KYDl 

LD D,A 

LD B,OOH 

DJNZ Dl 

CALL KYDl 

CP D 

JR NZ.TKO 

EXX 

RET 



KEY SCAN 

LD BCOOOOH 

LD HL,3801H 

LD A, (HL) 

OR A 

JR NZ.HDATA 

SLA L 

INC BC 

JP P. NEXT 

XOR A 

RET 

RRA 

JR CLOWBIT 

INC B 

JR HDATA 

BIT 6,L 

JR NZ.SPEC 

LD A,C 

RLCA 

HLCA 

RLCA 

OR B 

LD C,A 

LD A, (3880H) 

LD B,A 

LD A,08H 

CP L 

JR CNALPHA 



;WANT NEW CHARACTER 
;N0 NULLS 



:GET CHARACTER 

:SAVE 

: SHORT DELAY 



;IS IT THE SAME 
;NOT SAME TRY AGAIN 



;TURN ON BIT ZERO SCAN TO START 
;GET DATA 



JUNE 6 SPECIAL CHARACTERS 



;5 LSB HAVE LOW DATA 
lis SHIFT KEY PRESSED? 
.-THIS INFORI.IATION IS IN B 

:IF CARRY NOT ALPHA CHAR 
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02BF 3A4640 


04570 
04580 




LD A, (UCFLAG) 


02C2 Bl 


04590 




OR C 


02C3 CB40 


04600 




BIT 0,B 


02C5 2001 


04610 




JR NZ, CAPIT 


02C7 C9 


04620 




RET 


02Ce CBAF 


04630 


CAPIT 


RES 5, A 


02CA C9 


04640 




RET 


02CB CB6D 


04650 


NALPHA 


BIT 5,L 


02CD 200B 


04660 




JR NZ,N0T7 


02CF 3E30 


04670 


NALPHl 


LD A,30H 


02D1 Bl 


04680 




OR C 


02D2 CB40 


04690 




BIT 0,B 


02D4 2001 


04700 




JR NZ.CHAR 


02D6 C9 


04710 




RET 


02D7 CBA7 


04720 


CHAR 


RES 4, A 


02D9 C9 


04730 




RET 


02DA 3A2038 


04740 


N0T7 


LD A, (3820H) 


02DD FEIO 


04750 




CP lOH 


02DF 3 BEE 


04760 




JR C, NALPHl 


02E1 78 


04770 




LD A,B 


02E2 EEOl 


04780 




XOR OIH 


02E4 47 


04790 




LD B.A 


02E5 18E8 


04800 




JR NALPHl 


02E7 213B00 


04810 


SPEC 


LD HL, TABLE 


02EA 78 


04820 




LD A,B 


02EB 85 


04830 




ADD A,L 


02EC 6F 


04840 




LD L,A 


02ED 7E 


04850 




LD A. (HL) 


02EE C9 


04860 
04870 




RET 




04880 




;GET FETCHES 




04890 




;BY INC PIRSl 




04900 






02EF FD23 


04910 


GET 


INC lY 


02F1 FD7E00 


04920 


GETl 


LD A, (IT+OH) 


02F4 PEOl 


04930 




CP OIH 


02F6 CA6C00 


04940 




JP Z,COHAND 


02F9 FE20 


04950 




CP 20H 


02FB ce 


04960 




RET Z 


02FC FE2C 


04970 




CP ' , ' 


02FE CO 


04980 




RET NZ 


02FP B7 


04990 


GET3 


OR A 


0300 37 


05000 




SCF 


0301 D8 


05010 
05020 




RET C 


0302 FD23 


05030 


CONTIl 


INC lY 


0304 CDF102 


05040 


CONTIN 


CALL GETl 


0307 28F9 


05050 




JR Z, CONTIl 


0309 DA8000 


05060 




JP CCHND 


030C 3E3F 


05070 


ERROR 


LD A , ' ? ' 


030E FD7700 


05080 




LD (IY+0) ,A 


0311 CDEF02 


05090 


ERO 


CALL GET 


0314 3802 


05100 




JR CERl 


0316 18F9 


05110 




JR ERO 


0318 218040 


05120 


ERl 


LD HL, BUFFER 


031B CD8D01 


05130 




CALL PMSG 



;60H HERE IF LOWERCASE REQUIRED 
;OTHERWISE 40H FOR ONLY UPPERCASE 



:WAS SHIFT PRESSED 

:AC HAS UPPER CASE DATA 



:THIS IS NOW CHARACTER 



: TABLE MUST BE LOCATED 

;SUCH THAT THE FOLLOWING ADDITION 

:DOES NOT CROSS BOUNDRIES 



BY INC FIRST lY WILL ALWAYS POINT TO LAST VALUE 



: ENTER HERE FOR LAST 

: BREAK? 

; START ALL OVER 

; SPACE SET ZERO FLAG 

;FLAG SPACES 

:IF COMMA SET CARRY 

;ALL OTHERS RETURN 

;N0 ZERO 

:SET CARRY 



NEXT 

LAST CHARACTER IN STRING 

SKIP TRAILING SPACES 

FINISH OLD OR BACK TO BEGIN 

SHOW AT END 

SHOW IT 

ADJUST BUFFER 

KANT NEXT COMMA 

OUT ONLY WITH TRUE COMMA 

ODH STARTS THIS LINE 

OUTPUT BUFFER TEXT TO ERROR 
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-4. 



031E CD0701 
0321 DBFF 
0323 E640 
0325 2002 
0327 3E08 
0329 D3FF 
032B 18D7 



032D B703 
032F 6303 
0331 7A03 
0333 FEOl 
0335 A403 
0337 D903 
0339 D807 
033B C603 
033D 7804 
033F CF04 
0341 OC03 
0343 0CD3 
0345 ACQ4 
0347 B704 
0349 8D04 
034B C504 
034D 1B40 
034F D407 
0351 2307 
0353 F204 
0355 C603 
0357 1E40 
0359 3F05 
035B 6406 
035D 5E05 
035F 0C03 
0361 C103 



0363 
0366 
0368 
036B 
036E 
036F 
0372 
0374 
0375 
0376 
0378 



CD1402 

1620 

CD8001 

CDA201 

7E 

CDB201 

EDAl 

EO 

15 

28EE 

18F4 



05140 

05150 TOFFl 

05160 

05170 

05180 

05190 ER2 

05200 

05210 

05220 

05230 

05240 COMTAB 

05250 

05260 

05270 

05280 

05290 

05300 

05310 

05320 

05330 

05340 

05350 

05360 

05370 

05380 

05390 

05400 

05410 

05420 

05430 

05440 

05450 

05460 

05470 

05480 

05490 

05500 

05510 

05520 

05530 

05540 

05550 

05560 

05570 ASCII 

05580 ASCIIl 

05590 

05600 

05610 ASCII2 

05620 ASCII4 

05630 

05640 

05650 

05660 

05670 

05680 

05690 

05700 



CALL CLRBP 
IN A, (OFFH) 
AND 40H 
JE NZ,ER2 
LD A,08H 
OUT (OFFH) ,A 
JR CONTIN 

: COMMAND TABLE 



DEFW 
DEFW 
DEFW 
DEFW 
DEFW 
DEFW 
DEFW 
DEFW 
DEFW 
DEFW 
DEFW 
DEFW 
DEFW 
DEFW 
DEFW 
DEFW 
DEFW 
DEFW 
DEFW 
DEFW 
DEFW 
DEFW 
DEFW 
DEFW 
DEFW 
DEFW 
DEFW 



FILL 

ASCII 

BUFFR 

CLEARS 

DISPLY 

GO 

FINDON 

ENTER 

HEXM 

SUBSM 

ERROR 

ERROR 

LIST 

HOVE 

IN 

OUT 

PROM 

FINDTO 

READ 

INSERT 

ENTER 

USER 

VERIFY 

WRIT 

EXAM 

ERROR 

STEP 



iCLEAR BREAKPOINTS 
:GET STATUS OF SCREEN 
rIF ONE SMALL GRAPHIC 
ITURN OFF GRAPHIC 
:LD GRAPHIC CONTROL 
:ALL SET 
iCONTINUE WITH BUFFER 



FILL ADDRESS SPACE WITH CONSTANT 

ADDRESS OF ROUTINE 

ADDRESS OF BUFFER PROGRAM 

CLEAR SCREEN WITH 2QH 

ADDRESS OF ROUTINE 

EXECUTE WITH CURRENT SCREEN 

SEARCH FOR SINGLE BYTE 

EXECUTE WITH OLD SCREEN DATA 

ADDRESS OF HEXM 

INSERT DATA FROM BUFFER 

J 

K 

TOGGLE HARDCOPy SWITCH 

ADDRESS OF HOVE 

INPUT FROM PORT 

OUTPUT TO PORT 

PROM PROGRAMMER 

SEARCH FOR TWO BYTE INTEL FORMAT 

READ A CASSETTE TAPE WITH BIAS 

DATA FROM KEYBOARD 

TRANSFER FROM SCREEN TO VIDEO 

USER ROUTINE 

ADDRESS OF VERIFY 

WRITE A TAPE ON CASSETTE 

ADDRESS 

[SINGLE STEP IF HARDWARE ADDED 
iKITH OLD SCREEN DATA 



COMMAND SUBROUTINES 

DISPLAY IN ASCII FORMAT WITH GRAPHICS 



CALL G2N 
LD D,32D 
CALL ADDR 
CALL SPACE 
LD A, (HL) 
CALL CRT 
CPI 

RET PO 
DEC D 

JR Z, ASCIIl 
JR ASCII2 



GET ARGUHENTS 

56 DECIMAL POSITIONS MAX 

PRINT LOCATION OF BEGINNING LINE 

SPACE 

GET DATA 

ASCII DUMP FINISHED? 
CHANGE LATER FOR STRING 
FINISHED WITH LINE? 
NOT FINISHED WITH LINE 
NOT FINISHED 



; BUFFER SAVE ANB EXECUTE ROUTINES 
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037A CDEF02 


05710 


BUFFR 


CALL GET : 


GET NEXT DATA 


037D DA9303 


05720 




JP CTRAN ; 


TRANSFER SAVED BUFFER 


0380 FE53 


05730 




CP 's' ; 


SAVE BUFFER 


0382 2801 


05740 




JR Z,SAVE ; 


IGNORE ALL ELSE 


0384 C9 


05750 




RET 


CONTINUE AND IGNORE 


0385 218040 


05760 


SAVE 


LD HL, BUFFER ; 


BUFFER BEGINNING 


0388 010001 


05770 




LD BCIOOH ; 


PLENTY 


038B 118041 


05780 




LD DE,TEM : 


PLACE TO SAVE 


03 8E EDBO 


05790 




LDIR 


TRANSFER COMMAND TEXT 


0390 FD23 


05800 




INC lY 


BYPASS THE S FOR CONTIN 


0392 C9 


05810 




RET 




0393 218041 


05820 


TRAN 


LD HL.TEM 




0396 010001 


05830 




LD BCIOOH 


ONE PAGE OF BUFFER 


0399 118040 


05840 




LD DE, BUFFER 




039C D5 


05850 




PUSH DE 




039D PDEl 


05860 




POP lY 




03 9P EDBO 


05870 




LDIR 




03A1 C38A00 


05880 




JP CD 


QUICK WAY TO LOAD BUFFER 




05890 












05900 






DISPLAY IN HEXFORHAT 




05910 










03A4 CD1402 


05920 


DIEPLY 


CALL G2N 


GET ARGUMENTS 


03A7 CD8001 


05930 


DISPl 


CALL ADDR 


PRINT HEM ADDRESS 


03AA CD5C01 


05940 


DISP2 


CALL SPCHL 


SPACE FOLLOWED BY HEX DATA 


03AD EDAl 


05950 




CPI 


INCREMENT POINTERS 


03AF EO 


05960 




RET PO 


BC=0 THEN DONE 


03B0 7D 


05970 




LD A,L 


GET ADDRESS OP HEM 


03B1 E60F 


05980 




AND OPH 


MASK ALL BUT LOW 


03B3 28F2 


05990 




JR Z, DISPl 


NEXT LINE 


03B5 18F3 


06000 




JR DISP2 


GO FINISH LINE 




06010 












06020 












06030 












06040 






PILL MEMORY HIT 


i CONSTANT 




06050 










03B7 CD0B02 


06060 


PILL 


CALL G3N 


■GET 3AKGU11ENTS. WHERE, 


03BA 7B 


06070 




LD A,E 


•KOW MANY AND WHAT 


03BB 77 


06080 


FILLl 


LD (HL) ,A 


•DO IT 


03BC EDAl 


06090 




CPI 


•INCREMENT POINTERS 


03BE EO 


06100 




RET PO 


•FINISHED? 


03BF 18FA 


06110 




JR FILLl 


•CONTINUE 




06120 












06130 






SINGLE STEP EXE 


:OTE WITH LAST SCREEN DATA 




06140 










03C1 3E01 


06150 


STEP 


LD A, 01 


; SINGLE STEP FLAG 


03C3 324240 


06160 
06170 




LD (SSFLAG) ,A 


; STORE AND PALL INTO GO 


03C6 2A3E40 


06180 


EHTEK 


LD HL, (SCREEN) 


; CURRENT SCREEN STORAGE 


03C9 11003C 


06190 




LD DE,3C00H 


;T0 BE PLACED HERE 


03CC 010004 


06200 




LD BC,0400H 


;ALL 1024 OF THEM 


03CF EDBO 


06210 




LDIR 


:DOES IT 


03D1 CDF102 


06220 




CALL GETl 


;LAST IN STRING 


03D4 FE54 


06230 




CP 'T' 


r TRANSFER IS ALL THAT IS 


03D6 CA6F00 


06240 
06250 




JP Z.COHl 


; REQUIRED THEN RETURN NO PR 




06260 




icET PC AND EXEC 


UTE WITHOUT SCREEN 




06270 






•IF ENTERED AT G 
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06280 










03D9 


0600 


06290 


GO 


LD B.OOH 


: BREAK COUNTER 




03DB 


FD23 


06300 




INC lY 


;ADJUST BUFFER 




03DD 


211240 


06310 




LD HL,RSTLOC 






03E0 


36C3 


06320 




LD (HL) ,0C3H 


;PUT JUMP THERE 




03E2 


21A600 


06330 




LD HL,RSAVE 


: ADDRESS FOR JUMP 




03E5 


221340 


06340 




LD (RSTLOC+1), 


HL; ADDRESS 




03E8 


318040 


06350 




LD SP, BREAKS 


;BREAKSTACK 




03EB 


CDF102 


06360 


GOl 


CALL GETl 


;NEXT DATA IN BUFFER 




03EE 


CCEF02 


06370 


G02 


CALL Z.GET 


.-NEXT IN BUFFER 




03F1 


28FB 


06380 




JR Z,G02 






03F3 


3841 


06390 




JR C. LDREG 


;USE STORED PC 




03F5 


FE2E 


06400 




CP ' .' 


: BREAKPOINT? 




03F7 


280A 


06410 




JR Z, BREAK 


rIT IS A BREAK 




03F9 


FD2B 


06420 




DEC IT 


/ADJUST FOR 1ST DIGIT OF 


ADDR 


03FB 


CD4302 


06430 




CALL GHL 


: START OR BREAK 




03FE 


223C40 


06440 




LD (PCSAVE) ,HL 


:NEW PC 




0401 


18E8 


06450 




JR GOl 


; CONTINUE 




0403 


CDEF02 


06460 


BREAK 


CALL GET 


iNEXT CHARACTER 




0406 


FE2B 


06470 




CP ' + ' 


: RELATIVE JUMP 




0408 


2816 


06480 




JR Z,PLUS 






040A 


FE2D 


06490 




CP '-' 






040C 


281C 


06500 




JR Z, MINUS 






040E 


FD2B 


06510 




DEC ly 


:N0 RELATIVE JUMP 




0410 


CD4302 


06520 




CALL GHL 


:GET ABSOLUTE VALUE 




0413 


7E 


06530 


BREAKl 


LD A, (HL) 


;GET CODE AT ADDRESS 




0414 


ES 


06540 




PUSH HL 


;SAVE ADDRESS 




0415 


F5 


06550 




PUSH AF 


:SAVE DATA 




0416 


3EFF 


06560 




LD A,RST 


/RESTART 




0418 


77 


06570 




LD (HL),A 


;SAVE IT AS BREAK 




0419 


04 


06580 




INC B 


/BREAK COUNTER 




041A 


78 


06590 




LD A,B 






041B 


324540 


06600 




LD (BPNO) ,A 


/SAVE 




041E 


18CB 


06610 




JR GOl 


/CONTINUE 




0420 


CD4302 


06620 


PLUS 


CALL GHL 


/GET RELATIVE VALUE 




0423 


EB 


06630 




EX DE,HL 


/SAVE IN DE 




0424 


2A3C40 


06640 




LD HL, (PCSAVE) 


/PROGRAM COUNTER 




0427 


19 


06650 




ADD HL,DE 


/BREAKPOINT COMPUTED 




0428 


18E9 


06660 




JR BREAKl 






042A 


CD4302 


06670 


MINUS 


CALL GHL 


/GET RELATIVE VALUE 




042D 


EB 


06680 




EX DE.HL 






042E 


2A3C40 


06690 




LD HL, (PCSAVE) 






0431 


B7 


06700 




OR A 


/CLEAR CARRY 




0432 


ED52 


06710 




SBC HL,DE 






0434 


18DD 


06720 




JR BREAKl 


/RELATIVE JUMP COMPUTED 




0436 


FD224840 


06730 


LDREG 


LD (BPOINT),iy 


/SAVE BUFFER POINTER AT B 


POINT 


043A 


21D300 


06740 




LD HL,00D3H 


/OUT INSTRUCTION PORT 00 




043D 


22A042 


06750 




LD (JMP),HL 






0440 


21FBC3 


06760 




LD HL,0C3FBH 


/ENABLE INT AND JUMP 




0443 


22A242 


06770 




LD (JMP+2),HL 






0446 


2A3C40 


06780 




LD HL, (PCSAVE) 


/EXECUTE ADDRESS 




0449 


22A442 


06790 




LD (JHP+4),HL 


/ADDRESS IN PLACE 




044C 


312640 


06800 




LD SP.BOTHS 


/REGISTER DATA 




044F 


DDEl 


06810 




POP IX 






0451 


FDEl 


06820 




POP lY 


/RESTORE IX AND lY 




0453 


Fl 


06830 




POP AF 


/INTERRUPT INFORMATION 




0454 


ED47 


06840 




LD I, A 


/LOAD INTERRUPT VECTOR 





141 



0456 


3001 


06850 


JR HC,G04 ; 


IF CARRY NO INTERRUPTS 


0458 


FB 


06860 


EI ; 


INTERRUPTS REQUESTED 


0459 


Fl 


06870 G04 


POP AF : 


THIS TIME IT IS AF ' 


045A 


CI 


06880 


POP BC 




045B 


Dl 


06890 


POP DE 




045C 


El 


06900 


POP HL ; 


PRIMES IN PLACE 


045D 


D9 


06910 


EXX 




045E 


08 


06920 


EX AF.AF' ; 


NOW SWITCH 


045F 


Fl 


06930 


POP AF 




0460 


CI 


06940 


POP BC 




0461 


Dl 


06950 


POP DE 




0462 


2A2440 


06960 


LD HL,(SSTACK) ; 


GET SYSTEM STACK POINTER 


0465 


F9 


06970 


LD SP.HL 


STACK IN PLACE 


0466 


2A3A40 


06980 


LD HL, (HLSAVE) 


HL OK 


0469 


F5 


06990 


PUSH AF 


SAVE AF ON USER STACK 


046A 


3A4240 


07000 


LD A, (SSFLAG) 


SINGLE STEP? 


046D 


B7 


07010 


OR A 


THIS IS HOW WE FIND OUT 


046E 


2804 


07020 
07030 


JR Z, POPAF 








07040 


IwiTH HARDWARE TC 


PRODUCE INTERRUPT 






07050 






0470 


PI 


07060 


POP AF 




0471 


C3A042 


07070 


JP JHP 


DO OUTPUT AND ENABLE INT 


0474 


Fl 


07080 POPAF 


POP AF 


RESTORE REGISTERS 


0475 


C3A342 


07090 
07100 


JP JI1P+3 


GO EXECUTE 






07110 


:HEX MATH FIRST SUM THEN DIFFERENCE 






07120 


; 




0478 


CD4302 


07130 HEXM 


CALL GHL 


GET ARGUMENTS 


047B 


EB 


07140 


EX DE,Ht 




047C 


CD4302 


07150 


CALL GHL 


2ND ARGUMENT 


047F 


E5 


07160 


PUSH HL 


SAVE 2ND ARGUMENT 


0480 


19 


07170 


ADD HL,DE 


GET SUM 


0481 


CD8301 


07180 


CALL ADDRl 


NUMBER FOLLOWED BY : 


0484 


El 


07190 


POP HL 


GET 2ND BACK 


0485 


EB 


07200 


EX DE.HL 


PUT IN PROPER ORDER 


0486 


AF 


07210 


XOR A 


CLEAR BORROW FLAG 


0487 


ED52 


07220 


SBC HL,DE 


GET DIFFERENCE 


0489 


CD7901 


07230 


CALL PNHL 


DISPLAY SECOND NUMBER 


048C 


C9 


07240 
07250 


RET 


FINISHED 






07260 


; INPUT FROM PORT 


XX AND DISPLAY 






07270 






048D 


CD1402 


07280 IN 


CALL G2N 


GET PORT DESIRED 


0490 


41 


07290 


LD B,C 


NUMBER OF INPUT PORTS IN 


0491 


4D 


07300 


LD C.L 


C HAS PORT TO INPUT 


0492 


79 


07310 INNEXT 


LD A,C 


A GETS PORT NUMBER 


0493 


CD6001 


07320 


CALL PHEX 


OUTPUT PORT NUMBER 


0496 


CD8601 


07330 


CALL ADDR2 


OUTPUT A : 


0499 


CDA201 


07340 


CALL SPACE 




049C 


ED78 


07350 


IN A, (C) 


•GET DATA 


049E 


CD6001 


07360 


CALL PHEX 


■OUTPUT DATA 


04A1 


CDA201 


07370 


CALL SPACE 


•SPACE 


04A4 


CDA201 


07380 


CALL SPACE 




04A7 


05 


07390 


DEC B 


•ALL PORTS INPUT 


04A8 


C8 


07400 


RET Z 


•YES, COMMAND STRING 


04A9 


OC 


07410 


INC C 


•NEXT PORT 



IN SEQUENCE 
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04AA 


18E6 


07420 
07430 




JR IKNEXT 








07440 




ITURN ON HARD COPY FLAG 






07450 












07460 








04 AC 


PD23 


07470 


LIST 


INC lY 


ADJUST POINTER 


04AE 


3A4A40 


07480 




LD A, (PRNTFG) 


GET CURRENT FLAG 


04B1 


EEOl 


07490 




XOR OIH 


TOGGLE TO OPPOSITE STATE 


04B3 


324A40 


07500 




LD (PRNTFG) ,A 


RETURN TO STORAGE 


04B6 


C9 


07510 
07520 
07530 
07540 




RET 

.-MOVE MEMORY 


CONTINUE STRING 


04B7 


CD0B02 


07550 


HOVE 


CALL G3N 


GET ARGUMENTS OF FROM 


04BA 


E5 


07560 


HOVl 


PUSH HL 


HOW MUCH AND TO 


04BB 


D5 


07570 




PUSH DE 




04BC 


C5 


07580 




PUSH BC 


SAVE ARGUMENTS FOR VERIFY 


04BD 


EDBO 


07590 




LOIR 


ONE OF THOSE NICE Z-80 COD 


04BF 


CI 


07600 




POP BC 


RESTORE 


04C0 


Dl 


07610 




POP DE 




04C1 


El 


07620 




POP HL 


RESTORED NOW 


04C2 


C34205 


07630 
07640 




JP VERIFl 


JUMP TO VERIFY 






07650 




; OUTPUT HEX DATA 


TO PORT XX 






07660 








04CS 


CD4302 


07670 


OUT 


CALL GHL 


GET PORT NUMBER 


04C8 


4D 


07680 




LD C,L 


PORT MUST BE IN C 


04C9 


CD4302 


07690 




CALL GHL 


GET DATA 


04CC 


ED69 


07700 




OUT (C) ,L 


OUTPUT 


04CE 


C9 


07710 
07720 




RET 


FINISHED 






07730 




ISUBSTITUTE HEMOI 


lY FROM STRING OR KEYBOARD 






07740 








4CF 


CD4302 


07750 


SUBSH 


CALL GHL 


GET ADDRESS 


04D2 


CD8001 


07760 


SUBS 


CALL ADDR 


PRINT IT 


04D5 


E5 


07770 


SUBSl 


PUSH HL 


SAVE IT 


04D6 


CD4302 


07780 




CALL GHL 


GET NUMBER IN HL 


04D9 


CDF102 


07790 




CALL GETl 


LAST IN STRING 


04DC 


FE2P 


07800 




CP '/' 


ADDRESS OR DATA 


04DE 


280D 


07 810 




JR Z, NEWADl 


IT IS ADJUST STACK AND lY 


04E0 


7D 


07820 


SUBS3 


LD A,L 


ONLY L USED 


04E1 


El 


07830 




POP HL 


GET ADDRESS 


04E2 


77 


07840 




LD (HL) ,A 


•STORE 


04E3 


CD5C01 


07850 




CALL SPCHL 


•SHOW US 


04E6 


23 


07860 




INC HL 


•NEXT FORWARD POSITION 


04E7 


CDF102 


07870 




CALL GETl 


•LAST STRING ENTRY 


04EA 


DB 


07880 




RET C 


WAY OUT 


04EB 


18E8 


07890 




JR SUBSl 


•CONTINUE INSERTION OF DATA 


04ED 


FD23 


07900 


NEWADl 


INC lY 


ADJUST lY 


04EF 


Dl 


07910 


NEWADR 


POP DE 


DON'T DESTROY NEW ADDRESS 


04F0 


ISEO 


07920 
07930 
07940 
07950 




JR SUBS 

;FROM KEYBOARD 


PRINT NEW ADDRESS 


04F2 


CD4302 


07960 


INSERT 


CALL GHL 


GET ADDRESS 


04F5 


CD8001 


07970 


INSl 


CALL ADDR 




04F8 


CD5C01 


07980 


INS2 


CALL SPCHL 


SPACE FOLLOWED BY DATA 
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04FB 


ES 


07990 




PDSH HL 


SAVE ADDRESS 


04FC 


210000 


08000 




LD HL.OOH 


CLEAR DATA 


04FF 


0601 


08010 




LD B,01K 


COUNT 


0501 


3E3F 


08020 


PRISIT 


LD A, '?' 


PROMPT FOR SUBSTITUTE KEYBOARD 


0503 


CDB201 


08030 




CALL CRT 


TELL WE ARE LOOKING FOR DATA 


0506 


CD6E02 


08040 


1NS3 


CALL GBYTE 


DATA FROM KEYBOARD 


0509 


FEOD 


08050 




CP ODH 


ENTER? 


050B 


282E 


08060 




JR Z, FIRST 




050D 


FE08 


08070 




CP 08H 


GO BACK 


050P 


2826 


08080 




JR Z.BACKW 


RETURN PRINT ADDRESS 


0511 


FE20 


08090 




CP 2aH 


WILL NOT ALTER DATA 


0513 


2813 


08100 




JR Z,INCK 


INCREMENT AND KEEP 


0515 


CDB2ai 


08110 




CALL CRT 




0518 


FE2P 


08120 




CP '/' 


NEW ADDRESS 


051A 


2818 


08130 




JR Z, NADDS 


LAST STRING WAS ADDRESS 


051C 


CD5D02 


08140 




CALL VALHEX 


IS IT HEX 


051F 


38E0 


08150 




JR CPRINIT 


TRY AGAIN 


0521 


04 


08160 




INC B 




0522 


CD9701 


08170 




CALL LDHL 


SHIFT INTO HL PAIR 


0525 


C30605 


08180 




JP INS3 




0526 


El 


08190 


INCK 


POP HL 


GET OLD ADDRESS 


0529 


1803 


08200 




JR ENTl 




052B 


7D 


08210 


ENT 


LD A.L 


ONLY INFO IN L REQUIRED 


052C 


El 


08220 




POP HL 




052D 


77 


08230 




LD (HL),A 




052E 


CD5C01 


08240 


ENTl 


CALL SPCHL 


SPACE FOLLOWED BY DATA 


0531 


23 


08250 




INC HL 




0532 


18C1 


08260 




JR IHSl 




0534 


Dl 


08270 


NADDS 


POP DE 




0535 


18BE 


08280 




JR INSl 




0537 


El 


08290 


BACKV; 


POP HL 




0538 


2B 


08300 




DEC HL 




0539 


18BA 


06310 




JR INSl 


PRINT LAST ADDRESS 


053B 


IDEE 


08320 


FIRST 


DJNZ ENT 




053D 


El 


08330 




POP HL 




053E 


C9 


08340 
08350 
08360 
08370 




RET 

! VERIFY MEMORY 




053F 


CD0B02 


08380 


VERIFY 


CALL G3N 


GET ARGUMENTS 


0542 


lA 


08390 


VERIFl 


LD A, (DE) 




0543 


EDAl 


08400 




CPI 




0545 


2813 


08410 




JR Z,VERF2 


AGREES SO CONTINUE 


0547 


2B 


08420 




DEC HL 


GO BACK FOR DISPLAY 


0548 


CDBOOl 


08430 




CALL ADDR 


ADDRESS 


054B 


CD5C01 


08440 




CALL SPCHL 


AND DATA AT ADDRESS 


054E 


EB 


08450 




EX DE,HL 


NOW OTHER 


054F 


CDA201 


08460 




CALL SPACE 


SPACE 


0552 


CD8301 


08470 




CALL ADDRl 


ADDRESS BUT NOT NEW LINE 


0555 


CD5C01 


08480 




CALL SPCHL 


DATA AT OTHER ADDRESS 


0558 


EB 


08490 




EX DE,HL 


RESTORE 


0559 


23 


08500 




INC HL 


RESTORE HL 


055A 


13 


08510 


VERF2 


INC DE 


INC OTHER POINTER 


055B 


ED 


08520 




RET PO 


FINISHED? 


055C 


18E4 


08530 
06540 
06550 




JR VERIFl 
•EXAMINE REGISTEI 


CONTINUE 
?S 
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08560 






05SE 


CDEF02 


08570 


EXAM 


CALL GET 


0561 


28FB 


08580 




JR Z,EXAM 


0563 


3821 


08590 




JR CXALL 


0565 


FS 


08600 




PUSH AF 


0566 


CDEF02 


08610 




CALL GET 


0569 


D627 


08620 




SUB "1 


056B 


2804 


08630 




JR Z,EXAH2 


056D 


FD2B 


08640 




DEC lY 


056F 


3EFP 


08650 




LD A,OFFH 


0571 


3C 


08660 


EXAH2 


INC A 


0572 


324B40 


08670 




LD (PRIME) .A 


0575 


Fl 


08680 


EXAM 3 


POP AF 


0576 


214406 


08690 




LD HL,XTAB 


0579 


012000 


08700 




LD BC,32D 


057C 


EDAl 


08710 


CONTCP 


CPI 


057E 


CA1106 


08720 




JP Z.FOUHD 


0581 


E20C03 


08730 




JP PO, ERROR 


0584 


18F6 


087 40 




JR CONTCP 


0586 


AF 


08750 


XALL 


XOR A 


0587 


324B40 


08760 




LD (PRIMP) ,A 


058A 


216206 


08770 




LD HL.PCP 


058D 


CDC605 


08780 




CALL PVAL 


0590 


CDA201 


08790 




CALL SPACE 


0593 


214406 


08800 




LD HL.XTAB 


0596 


0606 


08810 




LD B,6H 


0598 


CDB905 


08820 




CALL ALU 


059B 


0609 


08830 


ALL 3 


LD B,9H 


059D 


CD9E01 


08840 




CALL NEWLIN 


05A0 


CDB90 5 


08850 




CALL ALLl 


05A3 


E5 


08860 




PUSH HL 


05A4 


C5 


08870 




PUSH BC 


05A5 


CDFA05 


08880 




CALL FLAGP 


05A8 


CI 


08890 




POP BC 


05A9 


El 


08900 




POP HL 


05AA 


3A4B40 


08910 




LD A, (PRIME) 


05AD 


3C 


08920 




INC A 


05AE 


324B40 


08930 




LD (PRIME) ,A 


05B1 


FE02 


08940 




CP 02H 


05B3 


C8 


08950 




RET Z 


05B4 


215006 


08960 




LD HL,RA 


05B7 


18E2 


08970 




JR ALL3 


05B9 


C5 


08980 


ALLl 


PUSH BC 


05BA 


CDC605 


08990 




CALL PVAL 


05BD 


F5 


09000 




PUSH AF 


05BE 


CDA201 


09010 




CALL SPACE 


05C1 


Fl 


09020 




POP AF 


05C2 


CI 


09030 




POP BC 


05C3 


10F4 


09040 




DJNZ ALLl 


05C5 


C9 


09050 




RET 


05C6 


46 


09060 


PVAL 


LD B,(HL) 


05C7 


23 


09070 




INC HL 


05C8 


7E 


09080 




LD A, (HL) 


05C9 


112440 


09090 


PVALl 


LD DE,SSTACK 


05CC 


83 


09100 




ADD A,E 


05CD 


5F 


09110 




LD E,A 


05CE 


7A 


09120 




LD A,D 



INEXT IN STRING 

IF , EXAMINE ALL 

SAVE REGISTER 

PRIME OR NOT 

IF PRIME STORE OIH IN PRIME 

NO NEED TO CORRECT POINTER 

ADJUST BUFFER POINTER 

WHEN INC WILL BE 

IT IS NOW OIH 

FLAG REFLECTS PRIME REGISTER 

GET REGISTER NAME 

:32 CHARACTERS AND DATA LOCATIONS 
/COMPARE (HL) TO A AND INC 

I NOT IN TABLE 

: CONTINUE COMPARISON 

; CLEAR A 

;HUST BE ZERO 

: PROGRAM COUNTER IN XTAB 

; PRINT 'P' AND CONTENTS OF PC 

JREGISTER TABLE 
;REST OF REGISTERS 
IDISPLAY S,lX,iy,N,I,V 
:NINE REGISTER DATA DISPLAY 



: PRINT FLAG DATA 



: PRINT NAME AND VALUE 



;REST OF REGISTERS 

;HL POINTS TO REG NAME 

; POINT TO BIAS 

ISIGN WILL HAVE DATA AS TO 1 OR 2 



:GET HIGH ORDER 
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05CF 


CEOO 


09130 




ADC A.OOH ; 


05D1 


57 


09140 




LD D,A ; 


05D2 


23 


09150 




INC HL ; 


05D3 


78 


09160 




LD A.B ; 


05D4 


CDB201 


09170 




CALL CRT 


05D7 


3A4B40 


09180 




LD A, (PRIMF) 


05DA 


B7 


09190 




OR A 


05DB 


2808 


09200 




JR Z, NPRIM 


05DD 


7B 


09210 




LD A,E 


05DE 


D608 


09220 




SUB 8H 


05E0 


5F 


09230 




LD E,A 


05E1 


3E27 


09240 




LD A, " ' 


05E3 


1802 


09250 




JR PRIME 


05E5 


3E3D 


09260 


NPRIM 


LD A,'=' 


05E7 


CDB201 


09270 


PRIME 


CALL CRT 


05EA 


CB7B 


09280 




BIT 7,E ; 


05EC 


2807 


09290 




JR 2, ONEB ; 


05EE 


CBBB 


09300 




RES 7,E ; 


OSFO 


lA 


09310 




LD A, (DE) : 


05F1 


CD6001 


09320 




CALL PHEX : 


05F4 


IB 


09330 




DEC DE : 


05F5 


lA 


09340 


ONEB 


LD A,(DE) ; 


05F6 


CD6001 


09350 




CALL PHEX 


05F9 


C9 


09360 




RET 


05FA 


47 


09370 


FLAGP 


LD B,A 


05FB 


CDA201 


09380 




CALL SPACE 


05FE 


213C06 


09390 




LD HL,FTAB 


0601 


CB20 


09400 


FLAGl 


SLA B 


0603 


3805 


09410 




JR C, OFLAG 


0605 


C8 


09420 




RET Z 


0606 


3E20 


09430 




LD A,20H 


0608 


1801 


09440 




JR FLAG2 


060A 


7E 


09450 


OFLAG 


LD A, (HL) 


060B 


CDB201 


09460 


FLAG2 


CALL CRT 


060E 


23 


09470 




INC HL 


060F 


18F0 


09480 




JR FLAGl 


0611 


4E 


09490 


FOUND 


LD C, (HL) - 


0612 


47 


09500 




LD B,A ; 


0613 


79 


09510 




LD A,C ; 


0614 


CDC905 


09520 




CALL PVALl ; 


0617 


CDEF02 


09530 


FOUNDl 


CALL GET : 


061A 


3811 


09540 




JR CNOTTWO ; 


061C 


28F9 


09550 




JR Z, FOUNDl ; 


061E 


FD2B 


09560 




DEC ly ; 


0620 


CD4302 


09570 




CALL GHL ; 


0623 


7D 


09580 




LD A,L ! 


0624 


12 


09590 




LD (DE) ,A 


0625 


79 


09600 




LD A,C ; 


0626 


B7 


09610 




OR A ; 


0627 


F22D06 


09620 




JP P.NOTTWO 


06 2 A 


13 


09630 




INC DE 


06 2B 


7C 


09640 




LD A,H : 


06 2C 


12 


09650 




LD (DE) ,A 


062D 


CDA201 


09660 


NOTTOO 


CALL SPACE 


0630 


79 


09670 




LD A,C ; 


0631 


CDC905 


09680 




CALL PVALl 


0634 


4F 


09690 




LD C,A ; 



PAGE BOUNDRY 
DOUBLE BYTE ADD 
POINT TO NEXT ENTRY 
PRINT NAME 



CHECK FOR ONE OR TWO BYTE NUMBER 

NO ADJUST IF ONE BYTE 

TWO BYTE, CORRECT BIAS 

GET VALUE 

PRINT IT 

DECREMENT POINTER 

GET VALUE 



SAVE BIAS AND NUMBER OF BYTES 

B REGISTER GETS NAME 

BIAS INTO AC 

WRITE FORMER CONTENTS 

DATA TO REPLACE OR END 

NEXT IN STRING 

SKIP BLANK (20H) 

ADJUST BUFFER POINTER GHL WANTS 

VALID HEX IN FIRST POSITION 

HOVE TO STACK 

IF ONLY ONE ITS IN L 

SIGN HAS 1,2 INFORMATION 

SET FLAG 

IP POSITIVE ONLY ONE BYTE 

GET HIGH DATA 



GET REGISTER INFORMATION 
DATA LAST PRINTED INTO C 
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0635 78 

0636 FE46 

0638 79 

0639 28BF 
063B C9 
063C 53 

0644 53 

0645 81 

0646 58 

0647 83 

0648 59 

0649 85 
064A 49 
064B 07 
064C 4E 
064D 06 
064E 56 
064F 9B 

0650 41 

0651 11 

0652 42 

0653 13 

0654 43 

0655 12 

0656 44 

0657 15 

0658 45 

0659 14 
065A 48 
065B 17 
065C 4C 
065D 16 
065E 4D 
065F 97 

0660 46 

0661 10 

0662 50 

0663 99 



0664 
0667 
0668 
0669 
066A 
066C 
066E 
0670 
0672 
0673 
0676 
0678 
067A 
067D 
067F 
06 82 



CD0B02 

D5 

E5 

C5 

3E04 

D3FF 

0600 

lOFE 

78 

CDEC06 

lOPB 

3BA5 

CDEC06 

3E55 

CDEC06 

0606 



09700 
09710 
09720 
09730 
09740 
09750 
09760 
09770 
09780 
09790 
09800 
09810 
09820 
09830 
09840 
09850 
09860 
09870 
09880 
09890 
09900 
09910 
09920 
09930 
09940 
09950 
09960 
09970 
09980 
09990 
10000 
10010 
10020 
10030 
10040 
10050 
10060 
10070 
10080 
10090 
10100 
10110 
10120 
10130 
10140 
10150 
10160 
10170 
10180 
10190 
10200 
10210 
10220 
10230 
10240 
10250 
10260 



FTAB 
XTAB 



GNAH3 

DT 

LEAD 

WRITl 



LD A,B 
CP 'F' 
LD A,C 
JS Z,FLAGP 
RET 



DEFH 
DEFH 



SZXHX/NC 
S' 



; CHECK FOR FLAG 

;IF FLAG PRINT FLAGS 

.•DATA BACK TO A FOR FLAG PRINT 

; RETURN TO STRING PROCESS 



85H 
'1' 



DEFH 
DEFB 
DEFH 
DEFB 07 H 
DEFH 'N' 
DEFB 06H 
DEFH 'V 
DEFB 9BH 
DEFH 'A' 
DEFB IIH 
DEFH 'E' 
DEFB 13H 
DEFH 'C 
DEFB 12H 
DEFH 'D' 
DEFB 15H 
DEFH 'E' 
DEFB 14H 
DEFH 'H' 
DEFB 17H 
DBFM 'L' 
DEFB 16H 
DEFH 'K' 
DEFB 97H 
DEFH 'F' 
DEFB lOH 
DEFH 'P' 
DEFB 99H 

CASSETTE WRITE ROUTINE 



CALL 
PUSH 
PUSH 
PUSH 
LD A, 
OUT ( 
LD B, 
DJNZ 
LD A 
CALL 
DJNZ 
LD A, 
CALL 
LD A, 
CALL 
LD B, 



G3N 

DE 

HL 

BC 

4H 

OFFH) 

OOH 

DT 

B 

TOUT 

LEAD 

0A5H 

TOUT 

55H 

TOUT 

06H 



; ZERO ACCUHULATOR 



IFILE NAHE HARK 
;WRITE NAHE HEADER 
:6 BYTE NAHE 



147 



0684 


CDF102 


10270 




CALL GETl 


LAST ENTRY 




06 87 


3S0E 


10280 




JR C.FINB 


IF COMMA NO NAME FILL BLANKS 


0689 


CDEF02 


10290 


WNAME 


CALL GET 


NEXT ENTRY 




068C 


3809 


10300 




JR CPINB 


FINISH WITH BLANKS 




068E 


CDEC06 


10310 




CALL TOUT 


WRITE NAME 




0691 


10F6 


10320 




DJNZ WNAKE 






0693 


FD23 


10330 




INC lY 


ADJUST BUFFER 




06 95 


1807 


10340 




JR WRIT3 


FULL NAME 




06 97 


3E20 


10350 


FINE 


LD A,20H 


FINISH WITH BLANKS 




0699 


CDEC06 


10360 




CALL TOUT 






06 9C 


10F9 


10370 




DJNZ FINE 






069E 


Dl 


10380 


WRIT3 


POP DE 






06 9F 


El 


10390 




POP HL 






06A0 


15 


10400 


WRIT2 


DEC D 






06A1 


FAD006 


10410 




JP M, FINISH 






Q6A4 


AF 


10420 




XOR A 






a6A5 


CDAA06 


10430 




CALL TDATA 






06A8 


18F6 


10440 




JR WRIT2 






06AA 


47 


10450 


TDATA 


LD B,A 






a6AB 


3E3C 


10460 




LD A,3CH 






06AD 


CDEC06 


10470 




CALL TOUT 






06B0 


78 


10480 




LD A,B 






06B1 


CDEC06 


10490 




CALL TOUT 






06B4 


7D 


10500 




LD A,L 






06BS 


CDEC06 


10510 




CALL TOUT 






06B8 


7C 


10520 




LD A,H 






06B9 


CDEC06 


10530 




CALL TOUT 






06BC 


7C 


10540 




LD A,H 






06BD 


22FE3F 


10550 




LD (3PFBH) ,HL 


SHOW SOMETHING 




06C0 


7C 


10560 




LD A,H 






06C1 


85 


10570 




ADD A,L 


START OF CHECKSUM 




06C2 


4F 


10580 




LD C,A 


CHECKSUM STORAGE 




06C3 


7E 


10590 


TDATAl 


LD A, (HL) 






Q6C4 


CDEC06 


10600 




CALL TOOT 






06C7 


7E 


10610 




LD A, (HL) 






06C8 


81 


10620 




ADD A,C 






06C9 


4F 


10630 




LD C.A 






06CA 


23 


10640 




INC HL 






06CB 


10F6 


10650 




DJNZ TDATAl 






06CD 


79 


10660 




LD A,C 






06CE 


181C 


10670 




JR TOUT 






06D0 


AF 


10680 


FINISH 


XOR A 






06D1 


BB 


10690 




CP E 






06D2 


2804 


10700 




JR z,vmiT5 


NOTHING TO WRITE .EXCEPT 


HEAD 


06D4 


7B 


10710 




LD A,E 


MORE TO COME 




06D5 


CDAA06 


10720 




CALL TDATA 






06D8 


3E78 


10730 


WRITS 


LD A,78H 


LAST BLOCK HEADER 




06DA 


CDEC06 


10740 




CALL TOUT 






06DD 


El 


10750 




POP HL 


EXECUTE ADDRESS 




06DE 


7D 


10760 




LD A,L 






06DP 


CDEC06 


10770 




CALL TOUT 






06E2 


7C 


10780 




LD A,H 






Q6E3 


CDEC06 


10790 




CALL TOUT 






06 E6 


CD7901 


10800 




CALL PNHL 


SHOW ADDRESS 




06S9 


C32103 


10810 




JP TOFPl 


TURN TAPE OFF 




06 EC 


D9 


10820 


TOUT 


EXX 


SAVE REGISTERS 




06 ED 


0E08 


10830 




LD C,8 
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06EF 


57 


10840 




LD D,A 




06F0 


37 


10850 


TOUTl 


SCF 


;CARRY WILL OUPTUT A PULSE 


06F1 


CD0607 


10860 




CALL PULSE 


;OUT SYNC PULSE 


06F4 


7A 


10870 




LD A,D 


;GET DATA BIT 


06F5 


07 


10880 




RLCA 


;PUT IN CARRY 


06F6 


57 


10890 




LD D,A 


; RETURN TO D REGISTER 


06F7 


CD0607 


10900 




CALL PULSE 


:OUT WHATEVER 


06FA 


OD 


10910 




DEC C 




06FB 


20F3 


10920 




JR NZ, TOUTl 




06FD 


3A8038 


10930 




LD A, (38B0H) 


; SHIFT PRESSED 


0700 


B7 


10940 




OR A 


:SET FLAG 


0701 


D9 


10950 




EXX 


[RETURN REGISTERS 


0702 


C22103 


10960 




JP NZ,T0FP1 


:IP NON-ZERO GET OUT 


0705 


C9 


10970 




RET 




0706 


3E02 


10980 


PULSE 


LD A,02H 


IWHEN RLA 04 WHICH IS OUT 


0708 


17 


10990 




RLA 


:0R 01 WITH CASSETTE ON 


0709 


D3FF 


11000 




OUT (OFFH) ,A 




070B 


0614 


11010 




LD B,20D 


; SHORT DELAY 


070D 


lOPE 


11020 


PI 


DJNZ PI 




070F 


E603 


11030 




AMD 03 H 


:KEEP INFORMATION BUT NO 


0711 


17 


11040 




RLA 


; CARRY 


0712 


F604 


11050 




OR 04H 


;KEEP RECORDER ON 


0714 


D3FF 


11060 




OUT (OFFH) ,A 


;1P 1 ANOTHER PULSE 


0716 


0614 


11070 




LD B,20D 


: DELAY 


0718 


lOFE 


11080 


P2 


DJNZ P2 




071A 


3E04 


11090 




LD A,04H 




071C 


D3FF 


11100 




OUT (OFFH) ,A 


; RETURN TO ZERO LEVEL 


071E 


065E 


11110 




LD B,94D 


JREMAINDER OF MIL'LISECOND 


07 20 


lOFE 


11120 


P3 


DJNZ P3 




0722 


C9 


11130 
11140 




RET 








11150 




CASSETTE READ 


ROUTINE 






11160 








0723 


CDEF02 


11170 


READ 


CALL GET 




0726 


28FB 


11180 




JR Z,READ 


ISKIP SPACES 


0728 


3807 


11190 




JR CRDll 




07 2A 


FD2B 


11200 




DEC lY 


lADJUST 


07 2C 


CD4302 


11210 




CALL GHL 




072F 


1803 


11220 




JR RD22 




0731 


210000 


11230 


RDll 


LD HL.OOH 




0734 


E5 


11240 


RD22 


PUSH HL 


;WILL POP TO DE 


0735 


3E04 


11250 




LD A,4H 




0737 


D3FF 


11260 




OUT (OFFH) ,A 


;TURN ON TAPE 


0739 


FD2B 


11270 




DEC lY 


; ADJUST 


073B 


CDAE07 


11280 


RDl 


CALL BIT 




073E 


FEA5 


11290 




CP 0A5H 


;SYNC? 


07 40 


20F9 


11300 




JR NZ,RD1 




0742 


2A4040 


11310 




LD HL, (CURSOR) 


;GET CURSOR WANT LOAD PAST 


0745 


0606 


11320 




LD B,6H 




0747 


CDA207 


11330 




CALL BYTE 




07 4A 


FE55 


11340 




CP 55H 




07 4C 


2039 


11350 




JR NZ.TOFF 




07 4E 


CDA207 


11360 


RD2 


CALL BYTE 




0751 


77 


11370 




LD (HL) ,A 




0752 


23 


11380 




INC HL 


;ADJUST POINTER AND PROVID 


0753 


10F9 


11390 




DJNZ RD2 




0755 


23 


11400 




INC HL 


: SPACE 
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0756 


224040 


11410 




LD (CURSOR). HL 


0759 


CDA207 


11420 


RD3 


CALL BYTE 


07 5C 


PE78 


11430 




CP 78H 


075E 


282A 


11440 




JR Z.ENDl 


0760 


FE3C 


11450 




CP 03CH 


0762 


2023 


11460 




JR NZ.TOFF 


0764 


CDA207 


11470 




CALL BYTE 


0767 


47 


11480 




LD B,A 


0768 


CDA207 


11490 




CALL BYTE 


076B 


6F 


11500 




LD L,A 


076C 


CDA207 


11510 




CALL BYTE 


076F 


67 


11520 




LD H,A 


0770 


22FE3F 


11530 




LD (3FFEH) ,HL 


0773 


85 


11540 




ADD A,L ; 


0774 


4F 


11550 




LD C,A 


0775 


Dl 


11560 




POP DE ; 


0776 


D5 


11570 




PUSH DE 


0777 


19 


11580 




ADD HL,DE ; 


0778 


CDA207 


11590 


RD4 


CALL BYTE 


077B 


77 


11600 




LD (HL) ,A 


077C 


23 


11610 




INC HL 


077D 


81 


11620 




ADD A,C 


077E 


4F 


11630 




LD C,A 


077F 


10F7 


11640 




DJNZ RD4 


0781 


CDA207 


11650 




CALL BYTE : 


0784 


B9 


11660 




CP C 


0785 


28D2 


11670 




JR Z,RD3 


0787 


C30C03 


11680 


TOFF 


JP ERROR 


07 8A 


CDA207 


11690 


ENDl 


CALL BYTE 


07 80 


6F 


11700 




LD L,A 


a78E 


CDA207 


11710 




CALL BYTE 


0791 


67 


11720 




LD H,A ; 


0792 


Dl 


11730 




POP DE 


0793 


110000 


11740 




LD DE.OOH ; 


0796 


19 


11750 




ADD HL.DE 


0797 


CD7901 


11760 




CALL PNHL 


07 9 A 


223C40 


11770 




LD (PCSAVE) ,HL ; 


07 9D 


FD23 


11780 




IMC lY : 


079F 


C32103 


11790 




JP TOPFl : 


07A2 


C5 


11800 


BYTE 


PUSH BC 


a7A3 


E5 


11810 




PUSH HL 


07A4 


0608 


11820 




LD B,8H 


07A6 


CDAE07 


11830 


BYTEl 


CALL BIT 


07A9 


lOFB 


11840 




DJNZ BYTEl 


07AB 


El 


11850 




POP HL 


07AC 


CI 


11860 




POP BC 


07AD 


C9 


11870 




RET 


07AE 


C5 


11880 


BIT 


PUSH BC 


07AF 


F5 


11890 




PUSH AF 


07B0 


3E04 


11900 




LD A,4H 


07B2 


D3FF 


11910 




OUT (OFFH) ,A ; 


07B4 


3A8038 


11920 


BITl 


LD A, (3880H) 


07 B7 


B7 


11930 




OR A i 


07BS 


20CD 


11940 




JR NZ,TOFF 


07BA 


DBFF 


11950 


BITS 


IN A, (OFFH) 


07BC 


17 


11960 




RLA 


07BD 


30F5 


11970 




JR NCBITl ; 



START OF CHECKSUM 
GET BIAS FOR LOAD 
BIAS ADDED TO HL 



GET CHECKSUM 



HL HAS START ADDRESS 
CORRECT STACK AND ZERO 



STORE TO PC PLACE 
ADJUST BUFFER 
TURNTAPE OFF 



RESET LATCH BEFORE READ 
SEE IF ESCAPE 



;WAIT FOR PULSE 



150 



07BF 


0640 


11980 




LD B,40H 


07C1 


lOFE 


11990 


BIT2 


DJNZ BIT2 


07C3 


3E04 


12000 




LD A,4H 


07C5 


D3FP 


12010 




OUT (OFFH) ,A 


07C7 


06 80 


12020 




LD B,80H 


07C9 


lOFE 


12030 


BIT3 


DJNZ BIT3 


07CB 


DBFF 


12040 




IN A, (OFFH) 


07CD 


4F 


12050 




LD C,A 


07CE 


Fl 


12060 




POP AF 


07CF 


CBll 


12070 




RL C 


07D1 


17 


12080 




RLA 


07D2 


CI 


12090 




POP BC 


07D3 


C9 


12100 
12110 
12120 
12130 




RET 

:FIMD ONE OR 


07D4 


3E02 


12140 


FINDTO LD A,02H 


07D6 


1802 


12150 




JR FIND 


07D8 


3E01 


12160 


FiMDON LD A,01H 


07DA 


324340 


12170 


FIND 


LD (COUNT) ,A 


07 DD 


CD0B02 


12180 




CALL G3N 


07E0 


7E 


12190 


FNDl 


LD A,E 


07E1 


EDAl 


122O0 


FND2 


CPI 


07E3 


EO 


12210 




RET PO 


07E4 


20FB 


12220 




JR NZ,FND2 


07E6 


3A4340 


12230 




LD A, (COUNT) 


07E9 


3D 


12240 




DEC A 


07 EA 


2806 


12250 




JR Z.SHOW 


a7EC 


7A 


12260 




LD A,D 


07ED 


BE 


12270 




CP (HL) 


07 EE 


2802 


12280 




JR Z,SHOW 


07F0 


18EE 


12290 




JR FNDl 


07F2 


3A4340 


12300 


SHOW 


LD A. (COUNT) 


07F5 


C5 


12310 




PUSH BC 


07F6 


4F 


12320 




LD C,A 


07F7 


0600 


12330 




LD B,00H 


07F9 


2B 


12340 




DEC HL 


07FA 


CDA703 


12350 




CALL DISPl 


07 FD 


CI 


12360 




POP BC 


07FE 


ISEO 


12370 
123 80 




JR FNDl 


GOOD 




12390 




END 


OOOOC 


TOTAL 


ERRORS 






ADDR 


0180 


02530 


05590 


05930 07760 07 


ADDR] 


0183 


02540 


07180 


08470 


addr; 


0186 


02550 


07330 




ADJUE 


T 0175 


02440 


02390 




ALLl 


05B9 


08980 


08820 


08850 09040 


ALLS 


059B 


08830 


08970 




ASCII 


0363 


05570 


05250 




ASCIIl 0366 


05580 


05660 




ASCII2 a36E 


05610 


05670 




ASCII4 036F 


05620 






BACKW 0537 


08290 


08080 




BIT 


07AE 


11880 


11280 


11830 



: SHORT DELAY 



: RESET LATCH 

;KINDOW TO LOOK FOR PULSE 



;IN DATA A 1 IS IN POSITION (7) 



:ONE BIT ROTATE THROUGH AC 



;FLAG FOR FINDING TWO BYTES 

FLAG FOR FINDING ONE BYTE 

SAVE FOR REFERENCE 

GET ARGUMENTS 

LOW ORDER BYTE OR ONLY BYTE 

IS IT THERE 

FINISHED AND NOT FOUND 

NOT THERE BUT CONTINUE SEARCH 

MORE THAN ONE 

IF ONE NOW ITS ZERO 

NEED SECOND BYTE 

IT MUST BE NEXT. THE CPI INC HL 

IT WAS THERE SO SHOW IT 

CONTINUE SEARCH START WITH FIRST 

GET NUMBER, DESTROYED BY DEC 

SAVE 

PREPARE FOR DISPLAY 

; ADJUST HL 

;SHOW ADDRESS FOLLOWED BY DATA 

;GET BYTES REMAINING 

: CONTINUE GET ALL OCCURRENCES 
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BITl 


07B4 


11920 


11970 








BIT2 


07C1 


11990 


11990 








BIT3 


07C9 


12030 


12030 








BITS 


07 BA. 


11950 










BKSP 


01 E7 


03210 


03070 








BOTMS 


4026 


00220 


06800 








BPNO 


4045 


00160 


01730 


01920 


06600 




BPOINT 


4048 


00170 


01630 


06730 






BREAK 


0403 


06460 


06410 








BREAKl 


0413 


06530 


06660 


06720 






BREAKS 


4080 


00250 


01810 


06350 






BUF 


0127 


01970 


00930 








BUFO 


012C 


01990 










BUFl 


012F 


02010 


02120 


02170 


02240 




BUFFER 


4080 


00090 


00250 


00910 


05120 05760 05840 




BUFFR 


037A 


05710 


05260 








BYTE 


07A2 


11800 


11330 
11650 


11360 
11690 


11420 11470 11490 11510 
11710 


11590 


BYTEl 


07A6 


11830 


11840 








CAPIT 


02Ce 


04630 


04610 








CD 


008A 


01050 


01060 


05880 






CHAR 


2D7 


04720 


04700 








CHKIN 


027E 


04140 


02840 


04050 






CLEAR 


0203 


03370 


03190 


03410 






CLEARS 


OlFE 


03350 


00790 


05270 






CLRBP 


0107 


01720 


00890 


01660 


05140 




CLRBPl 


OllD 


01870 


01900 








CMARK 


4044 


00150 


00840 


03250 






CMND 


0080 


01010 


05060 








COMl 


006F 


00910 


06240 








COMAND 


006C 


00900 


04940 








COMTAB 


032D 


05240 


01090 








CON 


002B 


00580 


00550 








COM! 


0033 


00620 


00590 








C0fI2 


004C 


00760 


00630 








CONTCP 


057C 


08710 


08740 








CONTIl 


0302 


05030 


05050 








CONTIN 


0304 


05040 


01020 


02860 


05200 




COUNT 


4043 


00140 


12170 


12230 


12300 




CRT 


01B2 


02930 


02160 
09270 


02220 
09460 


02640 05620 08030 08110 


09170 


CRTl 


OIBD 


03000 


02980 








CURSOR 


4040 


00120 


03020 


03240 


11310 11410 




Dl 


028A 


04210 


04210 








DELETE 


013E 


02080 










DISPl 


03A7 


05930 


01710 


05990 


12350 




DISP2 


03AA 


05940 


06000 








DISPLY 


03A4 


05920 


05280 








DLT 


0142 


02100 










DLTE 


0147 


02130 


02200 








DLTEl 


0148 


02140 










DT 


0670 


10180 


10180 








ENDl 


078A 


11690 


11440 








ENT 


.052B 


08210 


08320 








ENTl 


052E 


08240 


08200 








ENTER 


03C6 


06180 


05310 


05440 






ERO 


0311 


05090 


05110 
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ERl 


0318 


05120 


05100 












ER2 


0329 


05190 


05170 












ERROR 


0300 


05070 


01080 
08730 


01120 
11680 


03600 


03800 


05340 


05350 05490 


EXAM 


055E 


08570 


05480 


08580 










EXAM2 


0571 


08660 


08630 












EXAM3 


0575 


08680 














EXX 


OOCF 


01450 


01390 












FILL 


03B7 


06060 


05240 












FILLl 


03 BE 


06080 


00780 


06110 










FINB 


0697 


10350 


10280 


10300 


10370 








FIND 


07DA 


12170 


12150 












FINDON 


07D8 


12160 


05300 












FINDTO 


• 07D4 


12140 


05410 












FINISH 


06D0 


10680 


10410 












FIRST 


053B 


08320 


08060 












FLAGl 


0601 


09400 


09480 












FLAG2 


060B 


09460 


09440 












FLAGP 


05FA 


09370 


08880 


09730 










FNDl 


07E0 


12190 


12290 


12370 










PND2 


07E1 


12200 


12220 












FOUND 


0611 


09490 


08720 












FOUNDl 


0617 


09530 


09550 












FTAB 


063C 


09750 


09390 












PULSCN 


OlDl 


03120 


03100 












G2N 


0214 


03500 


03450 


05570 


05920 


07280 






G2N0 


021D 


03540 


03550 












G2N1 


0233 


03630 


03570 












G2N2 


023A 


03670 


03620 


03720 










G2N3 


023E 


03710 


03530 












G3N 


020B 


03450 


06060 


07550 


08380 


10110 


12180 




GBYTE 


026E 


04040 


02010 


04080 


04110 


08040 






GET 


02EF 


04910 


01050 


03540 


03770 


03820 


05090 


05710 06370 








06460 


08570 


08610 


09530 


10290 


11170 


GETl 


02F1 


04920 


03520 
10270 


03590 


05040 


06220 


06360 


07790 07870 


GET3 


02FF 


04990 














GHL 


0243 


03760 


03470 


03500 


03610 


03630 


06430 


06520 06620 








06670 


07130 


07150 


07670 


07690 


07750 07780 








07960 


09570 


11210 








GHLO 


0246 


03770 


03780 












GHLl 


0251 


03810 


03840 












GNAH3 


066A 


10150 














GO 
GOl 
G02 
G04 


03D9 
03 EB 
03EE 
0459 


06290 
06360 
06370 
06870 


05290 
06450 
06380 
06850 


06610 










HDATA 


02A6 


04400 


04340 


04430 










HEXH 


0478 


07130 


05320 












HLSAVE 


403A 


00240 


01270 


01330 


06980 








IN 


048D 


07280 


05380 












INCK 


0528 


08190 


08100 












INNEXT 


0492 


07310 


07420 












INSl 


04F5 


07970 


08260 


08280 


08310 








INS2 


04F8 


07980 














INS3 


0506 


08040 


08180 












INSERT 


04F2 


07960 


05430 
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JMP 42A0 00350 06750 06770 06790 07070 07090 

KYDl 0294 04300 04180 04220 

LDHL 0197 02700 03810 08170 

LDREG 0436 06730 06390 

LEAD 0673 10200 10210 

LINEF 01D5 03140 03050 

LIST 04AC 07470 05360 

LOWBIT 02AC 04440 04410 

MINUS 042A 06670 06500 

HONSP 42C0 00340 00350 00880 01010 01670 

HOVl 04BA 07560 

HOVE 04B7 07550 05370 

NADDS 0534 08270 08130 

NALPHl 02CF 04670 04760 04800 

NALPHA 02CB 04650 04560 

NEWADl 04ED 07900 07810 

NEWADR 04EP 07 910 

NEWLIN 019E 02800 01040 02530 08840 

NEXT 029A 04320 04370 

N0T7 02DA 04740 04660 

NOTTWO 062D 09660 09540 09620 

NPRIH 05E5 09260 09200 

OFLAG 060A 09450 09410 

OLD 4047 00270 04060 

ONES 05F5 09340 09290 

OUT 04C5 07670 05390 

0UT2 OlEB 03240 03130 03220 

PI 070D 11020 11020 

P2 0718 11080 11080 

P3 0720 11120 11120 

PCH 0150 02180 02070 

PCHAR 0152 02190 02090 

PCP 0662 10060 08770 

PCSAVE 403C 00230 00240 00290 01250 01420 01440 01690 06440 
06640 06690 06780 11770 

PHEX 0160 02310 02500 02520 07320 07360 09320 09350 

PHEXl 0170 02410 02450 

PHEXH 0163 02320 02310 

PHEXL 0167 02360 

PLUS 0420 06620 06480 

PMSG 018D 02610 02660 05130 

PHSGl OIBA 02600 00900 

PNHL 0179 02490 02540 07230 10800 11760 

POPAF 0474 07080 07020 

PPHL 015F 02300 

PRIME 05E7 09270 09250 

PRIMF 404B 00190 08670 08760 08910 08930 09180 

PRINIT 0501 08020 08150 

PRNT 01A4 02830 02410 02560 02810 

PRNTl 01A5 02840 02880 

PRNTFG 404A 00180 03290 07480 07500 

PROM 401B 00310 05400 

PULSE 0706 10980 10860 10900 

PVAL 05C6 09060 08780 08990 

PVALl 05C9 09090 09520 09680 

RA 0650 09880 08960 

RDl 073B 11280 11300 
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RDll 


0731 


11230 


11190 










RD2 


074E 


11360 


11390 










RD22 


0734 


11240 


11220 










RD3 


0759 


11420 


11670 










RD4 


0778 


11590 


11640 










READ 


0723 


11170 


05420 


11180 








REF 


4000 


00080 


00090 


00100 


00110 


00200 


00270 00280 00300 








00310 


00320 


00330 


00410 




REFl 


4040 


00110 


00120 
00190 


00130 


00140 


00150 


00160 00170 00180 


REF2 


4024 


00200 


00210 


00230 








RSAVE 


00A6 


01230 


06330 










RST 


OOFF 


00070 


06560 










RSTART 


0066 


00880 


02030 










RSTLOC 


4012 


00060 


06310 


06340 








SI 


OOOB 


00440 


00420 










S2 


0013 


00470 


00450 


00560 








S3 


OOIB 


00510 


00490 










S4 


0023 


00550 


00530 










SAVE 


0385 


05760 


05740 










SAVE! 


OODE 


01560 


01540 










SCREEN 


403E 


00290 


00810 


01610 


06180 






SHOW 


07P2 


12300 


12250 


12280 








SIGNON 


0043 


00730 


02600 










SPACE 


01A2 


02820 


02290 
09010 


05600 
09380 


07340 
09660 


07370 


07380 08460 08790 


SPCHL 


015C 


02290 


05940 


07850 


07980 


08240 


08440 08480 


SPEC 


02E7 


04810 


04450 










SSFLAG 


4042 


00130 


01370 


01410 


06160 


07000 




SSTACK 


4024 


00210 


00220 


00820 


01310 


06960 


09090 


STEP 


03C1 


06150 


05500 










SOBS 


04D2 


07760 


07920 










SUBSl 


04D5 


07770 


07890 










SUBS3 


04E0 


07820 












SUBSM 


04CF 


07750 


05330 










TABLE 


003B 


00650 


04810 










TDATA 


06AA 


10450 


10430 


10720 








TDATAl 


06C3 


10590 


10650 










TEH 


4180 


00100 


05780 


05820 








TOFF 


0787 


11680 


11350 


11460 


11940 






TOFPl 


0321 


05150 


10810 


10960 


11790 






TOUT 


06EC 


10820 


10200 


10230 


10250 


10310 


10360 10470 10490 








10510 


10530 


10600 


10670 


10740 10770 10790 


TOUTl 


06P0 


10850 


10920 










TRAN 


0393 


05820 


05720 










TTYP 


4018 


00300 


00770 


03310 








■mo 


0284 


04180 


04240 










UCFLAG 


4046 


00280 


01980 


04570 








USER 


401E 


00320 


05450 










USERSP 


4300 


00330 


00340 


00620 








VALHEX 


025D 


03890 


03790 


03830 


08140 






VERF2 


05SA 


08510 


08410 










VERIFl 


0542 


08390 


07630 


08530 








VERIFY 


053F 


08360 


05460 










VIDEO 


3C00 


00260 


03150 


03160 


03200 


03350 




WNAME 


0689 


10290 


10320 










WRIT 


0664 


10110 


05470 











tss 



WRITI 


0678 


10220 






WR1T2 


06A0 


10400 


10440 




WRIT3 


069E 


10380 


10340 




WRITS 


06D8 


10730 


10700 




XALL 


0586 


08750 


01680 


08590 


XTAB 


0644 


09760 


08690 


08800 



.»!, 
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APPENDIX E 



Source Listing for 

FROLIC IVionitor for the 

Model III TRS-80 
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00010 














C0020 




MODEL III TRS-80 


DEVELOPMENT SYSTEM 






00030 




DISK NAME HODIII/ASH 






00040 




MODEL III FROLIC 


MONITOR 






00050 










4012 




00060 


RSTLOC 


EQU 


4012H 




OOPF 




00070 


RST 


EQU 


OFFH 




4000 




00080 


REF 


EQU 


04000H 


; START OP RAM 


4080 




00090 


BUFFER 


EQU 


REF+80H 




4180 




00100 


TEH 


EQU 


REF+180H 


: SAVED BUFFER AREA 


4040 




00110 


REFl 


EQU 


REF+40H 




4040 




00120 


CURSOR 


EQU 


REFl 




4042 




00130 


SSFLAG 


EQU 


REFl+2 


; SINGLE STEP FLAG 


4043 




00140 


COUNT 


EQU 


REF1+3H 




4044 




00150 


CHARK 


EQU 


REFH-4H 




4045 




00160 


BPNO 


EQU 


REF1+5H 




4048 




00170 


BPOINT 


EQU 


REF1+8H 


: BUFFER POINTER 


404A 




00180 


PRNTFG 


EQU 


REFl+OAH 




404B 




00190 


PRIHF 


EQU 


REFl+OBH 




4024 




00200 


REF2 


EQU 


REF+24H 




4024 




00210 


SSTACK 


EQU 


REF2 




4026 




00220 


BOTMS 


EQU 


SSTACK+2H 




403C 




00230 


PCSAVE 


EQU 


REF2+18H 




403A 




00240 


HLSAVE 


EQU 


PCSAVE-2 




4080 




00250 


BREAKS 


EQU 


BUFFER 


rJUST BELOW BUFFER 


3C00 




00260 


VIDEO 


EQU 


3C00H 




4047 




00270 


OLD 


EQU 


REF+47H 




4046 




00280 


UCFLAG 


EQU 


REF+46H 




403E 




00290 


SCREEN 


EQU 


PCSAVE+2H 




4018 




00300 


TTYP 


EQU 


REF+18H 




401B 




00310 


PROM 


EQU 


REF+IBH 




401E 




00320 


USER 


EQU 


REF+IEH 




4300 




00330 


USERSP 


EQU 


REF+300H 


:USER STACK POINTER 


42C0 




00340 


MONSP 


EQU 


USERSP-40H 


; MONITOR STACKPOINTER 


42A0 




00350 
00360 


JHP 


EQU 


HONSP-20H 


;TOP OF MONITOR STACK 


0000 




00370 
003 80 




ORG 

: 


OOOOH 


:*•* FOR SYSTEM LOAD *** 


0000 


AF 


00390 




XOR 


A 


: CLEAR AC 


0001 


D3EC 


00400 




OUT 


(OECH) ,A 


: LOWER CASE AND CASSETTE OFF 


0003 


210040 


00410 




LD 


HL,REF 


; SYSTEM RAW 


0006 


1803 


00420 




JR 


SI 


;BY PASS RESTARTS 


0008 


C30040 


00430 




JP 


4000H 


:RST 1 


OOOB 


010003 


00440 


31 


LD 


BC,030QH 


tCLEAR 1ST 3 PAGES 


OOOE 


1803 


00450 




JB 


32 




0010 


C30340 


00460 




JP 


4003H 


;RST 2 


0013 


77 


00470 


S2 


LD 


(HL) ,A 




0014 


ED56 


00480 




IM 


1 


!SET INTERRUPT MODE 1 


0016 


1803 


00490 




JR 


S3 




0018 


C30640 


00500 




JP 


4006H 


;RST 3 


OOIB 


EDAl 


00510 


S3 


CPl 






OOID 


F3 


00520 




DI 




;DISABLE INTERRUPTS 


OOIE 


1803 


00530 




JR 


S4 




0020 


C30940 


00540 




JP 


4009H 


:RST 4 


0023 


E22B00 


00550 


S4 


JP 


PO.CON 


ICONTINUE INITIALIZATION 


0026 


18EB 


00560 




JR 


32 


: CONTINUE TO CLEAR RAM 


0028 


C30C40 


00570 




JP 


400CH 


;RST 5 



J%, 
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002B 
00 2D 
a02F 
0030 
0033 
0036 
0038 
003B 
003C 
003D 
003E 
003F 
0040 
0041 
0042 
0043 
0044 
004B 
004C 
004E 
0051 
0054 
0057 
005A 
0050 
0061 
0063 



0066 
0069 

ooec 

006F 
0072 
0073 
0076 
0078 
0079 
007B 
0Q7C 
007D 
007E 
0080 
0083 
0086 
0087 
008A 
008D 
008F 
0091 
0094 



3EC9 

1804 

00 

C30F40 

310043 

1814 

C31240 

OD 

DC 

01 

OB 

OA 

08 

09 

20 

OD 

46 

01 

0E09 

211840 

CDA903 

CDEDOl 

21003C 

223E40 

ED732440 

3EA0 

324440 



31BE42 

CD0701 

CD8A01 

218040 

E5 

CD2701 

362C 

23 

3601 

El 

77 

E5 

FDEl 

31C042 

21F802 

E5 

CD9E01 

CDE302 

28FB 

D640 

DADOOS 

211B03 



0097 FE5A 
0099 D20003 
009C 87 
009D 5F 



00580 
00590 
00600 
00610 
00620 
00630 
00640 
00650 
00660 
00670 
00680 
00690 
00700 
00710 
00720 
00730 
00740 
00750 
00760 
00770 
00780 
00790 
00800 
00810 
00820 
00830 
00840 
00850 
00860 
00870 
00880 
00890 
00900 
00910 
00920 
00930 
00940 
00950 
00960 
00970 
00980 
00990 
01000 
01010 
01020 
01030 
01040 
01050 
01060 
01070 
01080 
01090 
01100 
OHIO 
01120 
01130 
01140 



LD A,0C9H 

JR CONl 

NOP 

JP 400FH 

LD SP. USERS? 

JR C0N2 

JP 4012H 

DEFB ODH 

DEFB OCH 

DEFB OIH 

DEFB OBH 

DEFB OAH 

DEFB 08H 

DEFB 09H 

DEFB 20H 

DEFB ODH 

DBFH 'FROLIC: ' 

DEFB OIH 

LD C,09 

LD HLjTTYP 

CALL FILLl 

CALL CLEARS 

LD HL,3C00H 

LD (SCREEN) ,HL 

LD (SSTACK),SP 

LD A.OAOH 

LD (CMARK) ,A 



;FILL 

;RST 6 

;SET USER STACK 



COMAND 
COMl 



:WILL INITIALIZE CURSOR 

;END OF MESSAGE 

[LOAD RETURNS IN USER RAM 

.-START OF FILL 

: CLEAR SCREEN ONLY ON POVJER UP 



IINITIALIZE USER STACK 
; CURSOR HARK 
; PLACE IN RAH 



RESET START OF PROGRAM 



LD SP,M0NSP-2 

CALL CLRBP 

CALL PHSGl 

LD HL, BUFFER 

PUSH HL 

CALL BUF 

LD (HL) ,2CH 

INC HL 

LD (HL) ,01H 

POP HL 

LD (HL) ,A 

PUSH HL 

POP lY 

LD SP,MONSP 

LD HL,CONTIN 

PUSH HL 

CALL NEKLIN 

CALL GET 

JR Z,CD 

SUB ' 6 ' 

JP C, ERROR 

LD HL.COHTAB 

CP >Z' 
JP NC, ERROR 
ADD A, A 
LD E,A 



INITIALIZE STACK 

CLEAR BREAKPOINTS 

FROLIC: 

BUFFER BEGINNING 

SAVE FOR LATER 

BUFFER AVAILABLE FOR OTHERS 

DELIMITER 

; BREAK AT END OF BUFFER 

;GET BUFFER BEGINNING 

;PUT ODH, ERRORS WILL DO LINEFEED 

BUFFER POINTER FOR MONITOR 

NECESSARY FOR COMMANDS 

RETURN ADDRESS ON STACK 

PUT RETURN ADDRESS ON STACK 

SAVES DOING IT IN COMMAND 

GET WILL GET FIRST NON ZERO CHAi 

IGNORE LEADING SPACES 

BORROW IF < S 

A 00 IF ' 

POINT TO COMMAND TABLE 

A BORROW IS ALWAYS GENERATED 

BORROW VALID 8 THRU Z 

; DOUBLE NUMBER 
;FOR DOUBLE ADD 
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009E 1600 

OOAO 19 

OOAl 5E 

aOA2 23 

O0A3 56- 

aOA4 EB 

O0A5 E9 



00A6 
00A7 
OOAS 
OOAB 
DOAC 
OOAF 
OOBO 
aOB3 
00B4 
00B7 
00B8 
QDBB 
OOBC 
OOBD 
ODBE 
OOCl 

oac2 

QDC4 
00C5 
00C8 
OOCB 
ODCC 
OOCP 
OODG 
OODl 
00D2 
O0D3 
Q0D4 
00D5 
00D7 
00D8 
OODA 
OODD 
CODE 
OODF 
OOEl 
00E3 
00E6 
00E9 
00 ED 
00 EF 
00F3 
00F4 
OOFS 
OOFS 
OOFB 
OOFE 
Old 
0104 



E3 

2B 

223C40 

El 

223A40 

F5 

210200 

39 

222440 

Fl 

313A40 

D5 

C5 

F5 

3A4240 

B7 

280B 

AF 

324240 

2A3C40 

23 

223C40 

D9 

E5 

D5 

C5 

08 

F5 

ED57 

67 

2E00 

E2DE00 

2C 

E5 

FDE5 

DDES 

21003C 

010004 

EDSB3E40 

EDBO 

FD2A4840 

3B 

3B 

CD0701 

31BE42 

CD7B0S 

2A3C40 

OlOSOO 

C39503 



01150 

01160 

01170 

01180 

01190 

01200 

01210 

01220 

01230 RSAVE 

01240 

01250 

01260 

01270 

01280 

01290 

01300 

01310 

01320 

01330 

01340 

01350 

01360 

01370 

01380 

01390 

01400 

01410 

01420 

01430 

01440 

01450 EXX 

01460 

01470 

01480 

01490 

01500 

01510 

01520 

01530 

01540 

01550 

01560 SAVEl 

01570 

01580 

01590 

01600 

01610 

01620 

01630 

01640 

01650 

01660 

01670 

01680 

01690 

01700 

01710 



LD D,OH 
ADD HL,DE 
LD E,(HL) 
INC HL 
LD D, (HL) 
EX DE,HL 
JP (HL) 

EX (SP) ,HL 

DEC HL 

LD (PCSAVE),HL 

POP HL 

LD (HLSAVE) ,HL 

PUSH AF 

LD HL,0002H 

ADD HL,SP 

LD (SSTACK) ,HL 

POP AF 

LD SP, HLSAVE 

POSH DE 

PUSH BC 

PUSH AF 

LD A.(SSPLAG) 

OR A 

JR Z,EXX 

XOR A 

LD (SSFLAG) ,A 

LD HL,(PCSAVE) 

INC HL 

LD (PCSAVE) ,HL 

EXX 

PUSH HL 

PUSH DE 

PUSH BC 

EX AF,AF' 

PUSH AF 

LD A,l 

LD H,A 

LD L,00H 

JP PO, SAVEl 

INC L 

PUSH HL 

PUSH XY 

PUSH IX 

LD HL,3C00H 

LD BC,0400H 

LD DE, (SCREEN) 

LDIR 

LD IY,(BPOINT) 

DEC SP 

DEC SP 

CALL CLRBP 

LD SP,M0NSP-2 

CALL XALL 

LD HL, (PCSAVE) 

LD BCOSH 

JP DISPl 



BE AT A PAGE BOUNDARY 

DAD WITH CARRY SET FROM COMPARE 

GET LOW BYTE 

GET HIGH BYTE 
JUMP TO ADDRESS 
EXECUTE REST OF COMMAND 

GET PROGRAM COUNTER 

ADJUST 

AND SAVE 

SAVE HL AND ADJUST STACKPOINTER 

SAVE FLAGS IN FORMER HL 

ADJUST FOR RST OR INT 

GET SYSTEM USER STACK 

SYSTEM STACK STORAGE 

GET FLAGS BACK 

START OF REGISTER SAVE 



FLAGS ON STACK 

SINGLE STEP? 

TEST 

NO SINGLE STEP IF ZERO 

NOW ZERO 

CORRECT FLAG 

GET PC COUNTER 

ADJUST 

REPLACE 



GET INT VECTOR AND I IF FLAG 

STORE IN H 

INITIALIZE L 

IF PARITY FLAG NOT SET IFF INT D 

IFF SET INDICATE WITH NON ZERO 

SAVE INT VECTOR AND INT SET FLAG 



START OF SCREEN TRANSFERRED 

AREA STARTING AT SCREEN 

GET LAST POSITION IN BUFFER 
MUST NOT DESTROY STACK 

CLEAR BREAK POINTS 
CORRECT STACK 
DISPLAY REGISTERS 
GET PROGRAM COUNTER 
NUMBER OF BYTES 
DISPLAY 
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0107 


210000 


01720 


CLRBP 




^D HL,OOH 


-CLEAR 


OlOA 


3A4540 


01730 




LD A, (BPNO) 


LD HL WITH NO OF BPOINTS 


MOD 


B7 


01740 




OR A 


SET ZERO FLAG 


OlOE 


6F 


01750 




LD L,A 


STORE JUST IN CASE 


OlOF 


C8 


01760 




RET Z 


IF NO BREAKPOINTS GO TO COMMAND 


0110 


CI 


01770 




POP BC 


GET RETURN ADDRESS 


0111 


29 


01780 




ADD HL,HL 


DOUBLE VALUE IN L 


0112 


29 


01790 




ADD HL.HL 


AND AGAIN 


0113 


EB 


01800 




EX DE.HL 




0114 


218040 


01810 




LD HL, BREAKS 




0117 


ED52 


01820 




SBC HL,DE 


BORROW CLEAR DECREMENT STACK 


0119 


F9 


01830 




LD SP,HL 


NEW STACK POSITION TOP 


OllA 


C5 


01840 




PUSH BC 




OllB 


El 


01850 




POP HL 


READY FOR RETURN 


one 


47 


01860 




LD B,A 


SHOULD STILL HAVE NUMBER 


OllD 


Fl 


01870 


CLRBPl 


POP AF 




OllE 


Dl 


01880 




POP DE 




OllF 


12 


01890 




LD (DE) ,A 




0120 


lOFB 


01900 




DJNZ CLRBPl 




0122 


AF 


01910 




XOR A 




0123 


324540 


01920 




LD (BPNO) ,A 


PUT ZERO IN BPNO 


0126 


E9 


01930 




JP (HL) 


HL HAS RETURN ADDRESS 






01940 














01950 






FILL BUFFER WITH COMMAND STRING 






01960 










0127 


3E40 


01970 


BUF 


LD A.40H 


IP ENTERED HERE ONLY UPPER CASE 


0129 


324640 


01980 




LD (UCFLAG) ,A 


40H IS UPPER FLAG, 60H FOR LC 


012C 


23 


01990 


BUFO 


INC HL 


LEAVE ROOM FOR BUFFER COUNT 


012D 


0601 


02000 




LD B,01H 


ROOM FOR COUNT, COMMA, AND OIH 


012F 


CD5D02 


02010 


BUPl 


CALL GBYTE 


GET CHARACTER RETURN WITH DATA 


0132 


FEOl 


02020 




CP OIH 


ESCAPE FROM BUFFER ENTRY 


0134 


CA6600 


02030 




JP Z.RSTART 


RETURN TO COMMAND, SP IS OK 


0137 


PEOD 


02040 




CP ODH 


CARRIAGE RETURN 


0139 


C8 


02050 




RET Z 


RETURN TO CALLING ROUTINE 


013A 


FEOC 


02060 




CP OCH 


CLEAR SCREEN 


013C 


2812 


02070 




JR Z,PCH 


CHANGE DATA TO K COMMAND 


013E 


FEDS 


02080 


DELETE 


CP 08H 


BACKSPACE? 


0140 


2010 


02090 




JR NZ, PCHAR 


NO INSERT CHAR INTO BUFFER 


0142 


3E01 


02100 


DLT 


LD A, OIH 


BEGINNING? 


0144 


B8 


02110 




CP B 


IS IT 


0145 


28E8 


02120 




JR ZrBUPl 


CAN'T GO BACK FURTHER 


0147 


2B 


02130 


DLTE 


DEC HL 


DECREMENT BUFFER 


0148 


OS 


02140 


DtTEl 


DEC B 


AND COUNT 


0149 


3E08 


02150 




LD A,08H 




014B 


CDB201 


02160 




CALL CRT 


REMOVE FROM SCREEN 


014E 


18DF 


02170 




JR BOFl 


GET NEXT CHAR 


0150 


3E43 


02180 


PCH 


LD A,'C' 


CLEAR SCREEN 


0152 


04 


02190 


PCHAR 


INC B 


IS THERE ROOM? 


0153 


28F2 


02200 




JR ZjDLTE 


NO SO DO AUTOMATIC 08H 


0155 


77 


02210 




LD (HL) ,A 




0156 


CDB201 


02220 




CALL CRT 


LOAD IN BUFFER AND DISPLAY 


0159 


23 


02230 




INC HL 


NEXT POSITION IN BUFFER 


015A 


18D3 


02240 




JR BDFl 


GET NEXT CHARACTER 






02250 














02260 






FOLLOWING ARE PRINT ROUTINES AND DATA 






02270 






CONDITIONING FOI 


* THESE SUBROUTINES 






02280 











161 



015C 
015F 
0160 
0163 
0164 
0165 
0166 
0167 
0168 
ai6A 
016C 
016E 
0170 
0173 
0174 
0175 
0177 



CDA201 

7E 

CD6301 

OF 

OF 

OF 

OF 

F5 

E60F 

FBOA 

3007 

F630 

CDA401 

Fl 

C9 

C637 

18F7 



0179 7C 
017A CD6001 
017D 7D 
017E 18E0 

0180 CD9E01 
0183 CD7901 
0186 3E3A 
0188 181A 



018A 214300 
018D 7E 
018E FEOl 

0190 CB 

0191 CDB201 

0194 23 

0195 18F6 



0197 29 

0198 29 

0199 29 
019A 29 
01 9B B5 
019C 6F 
019D C9 



019E 3E0D 
OlAO 1802 
01A2 3E20 
01A4 P5 
01A5 CD6D02 



02290 
02300 
02310 
02320 
02330 
02340 
02350 
02360 
02370 
02380 
02390 
02400 
02410 
02420 
02430 
02440 
02450 
02460 
02470 
02480 
02490 
02500 
02510 
02520 
02530 
02540 
02550 
02560 
02570 
02580 
02590 
02600 
02610 
02620 
02630 
02640 
02650 
02660 
02670 
02680 
02690 
02700 
02710 
02720 
02730 
02740 
02750 
02760 
02770 
02780 
02790 
02800 
02810 
02820 
02830 
02840 
02850 



SPCHL 
PPHL 
PHEX 
PHEXH 



PHEXl 



ADDR 

ADDRl 

ADDR2 



PMSGl 
PMSG 



CALL SPACE 

LD A, (HL) 

CALL PHEXH 

RRCA 

RRCA 

RRCA 

RRCA 

PUSH AF 

AND OFH 

CP OAH 

JR NC, ADJUST 

OR 30H 

CALL PENT 

POP AF 

RET 

ADD A,37H 

JR PHEXl 



; PRINT A SPACE FOLLOWED BY 
;THE NUMBER LOCATED AT (HL) 
:TWO NIBBLES MUST BE OUTPUT 
;GET HIGH HEX VALUE 



ISWAP COMPLETE 

:GET LOW HEX VALUE 

IMASK 

; GREATER THAN 9 

jTHEN NO CARRY 

;NOW ASCII FOR 0-9 

?O0TPUT 

;GET AND ADJUST SP 

: ADJUST FOR ALPHABETIC 



PRINTS NUMBER IN HL REGISTER AS ADDRESS 



LD A,H 
CALL PHEX 
LD A,L 
JR PHEX 
CALL NEWLIN 
CALL PNHL 
LD A,' : ' 
JR PRNT 



PRINT MESSAGE 

LD HL.SIGNON 
LD A, (HL) 
CP OIH 
RET Z 
CALL CRT 
INC HL 
JR PMSG 



! PRINT H FIRST 

;NOW L 

; RETURNS FROM CRT PROGRAM 

;D0 CR AND LINE FEED 

; PRINTS HL WHICH IS ADDRESS 

; DELIMITER 



; FROLIC: 

:GET DATA 

;END OF MESSAGE HARK 

! RETURNS FROM MESSAGES VIA BREAK 

;NEXT DATA 



SHIFT DATA THROUGH HL PAIR 



ADD HL,HL 
ADD HL,HL 
ADD HL,HL 
ADD HL,HL 
OR L 
LD L,A 
RET 



;0R AC IN SHIFT PATTERN 
: REPLACE L 



SPACE 

PRNT 

PRNTl 



PRINTS DATA IN A TO PRINT DEVICE 

LD A,ODH ;LINE FEED 

JR PRNT .-WANT TO BREAK ON NEW LINES 

LD A,20H : SPACE ADJUST 

PUSH AF ;SAVE 

CALL CHKIN ;HAS BREAK OR SPACE 



^^ 
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01A8 FEOl 
OlAA CA6600 
OlAD FE20 
OlAP 28F4 
OlBl Fl 



01B2 
01B3 
01E4 
01 B7 
01B9 
OIBB 
01 BD 
OIBF 
OlCl 
01C2 
01C3 
01C5 
01C7 
OICA 
OICD 
OlDO 
01D2 
aiD3 
aiD6 
01D9 
OlDA 
OIDD 
QlEO 
OlEl 
01E2 
01E3 
01 E6 
01 E7 
01 EA 
OlEB 
01 EC 
OlED 
OlFO 
Q1F2 
01P4 
01F5 
01F7 
01F8 



D9 

F5 

2A4040 

3620 

PBOD 

280A 

FE08 

2818 

77 

23 

CB7 4 

2813 

01C003 

liaD3C 

21403C 

EDBO 

EB 

CDF201 

21C13F 

2B 

224040 

3A4440 

77 

Fl 

4F 

3A4A40 

B7 

C41840 

79 

D9 

C9 

21003C 

FD23 

CB7 4 

CO 

3620 

23 

18F8 



OlFA CD0302 
OlFD EB 
OlFE CD3202 

0201 EB 

0202 C9 

0203 CD3202 

0206 EB 

0207 CDE5a2 



02860 

02870 

02880 

02890 

02900 

02910 

02920 

02930 

02940 CRT 

02950 

02960 

02970 

02980 

02990 

03000 

03010 

03020 

03030 

03040 

03050 

03060 LINEF 

03070 

030 80 

03090 

03100 

03110 

03120 

03130 BKSP 

03140 00T2 

03150 

03160 

03170 

03180 

03190 

03200 

03210 

03220 

03230 

03240 

03250 CLEARS 

03260 

03 27 CLEAR 

03280 

03290 

03300 

03310 

03320 

03330 

03340 

03350 G3N 

03360 

03370 

03380 

03390 

03400 G2N 

03410 

03420 



CP OIH 

JP ZrRSTART 

CP 20H 

JR ZjPRNTl 

POP AF 

CRT DISPLAY 

EXX 

PUSH AP 

LD HL, (CURSOR) 

LD (HL),20H 

CP ODH 

JR 2, LINEF 

CP 08H 

JR Z,BKSP 

LD (HL) ,A 

INC HL 

BIT 6,H 

JR Z,0UT2 

LD BC,03C0H 

LD DE, VIDEO 

LD HL,VIDEO+64D 

LDIR 

EX DE.HL 

CALL CLEAR 

LD HL,VIDEO+961D 

DEC HL 

LD (CURSOR) ,HL 

LD A, (CMARK) 

LD (HL) ,A 

POP AF 

LD C,A 

LD A, (PRNTFG) 

OR A 

CALL NZ,TTYP 

LD A,C 

EXX 

RET 

LD HL, VIDEO 

INC lY 

BIT 6,H 

RET NZ 

LD (HL),20H 

INC HL 

JR CLEAR 



;BEEN PRESSED 
;BACK TO BUFFER 



;YES, WAIT FOR RELEASE 
.-FALL INTO CRT DISPLAY 



;CRT OUTPUT OF DATA IN A 
:SAVE ON STACK 

: REMOVE CURSOR 
; CARRIAGE RETURN 

; BACKSPACE 

; PLACE CHARACTER ON SCREEN 
JADVANCE CURSOR 
:OFF PAGE? 

: 1024-64 MEMORY BYTES 

;ONE LINE FROM PAGE TOP 

: CLEAR LAST LINE 
; CLEAR LAST LINE 
: BEGIN OF LAST LINE 



MONITOR OR USER? 

CURSOR HARK 
:GET DATA FROM STACK 
■SAVE IN C 

HARD COPY? 

IN RAM A JUMP TO USER ROUTINE 
RESTORE DATA IN C 
ADJUST THOSE REGISTERS 



CORRECT BUFFER 

FINISHED 

WHEN THIS BIT GOES ONE 

SPACE ON SCREEN 

NEXT 

CONTINUE WITH CLEAR 



FILL ROUTlNbS FOR ADDRESS OR DATA 

CALL G2N ;GET TWO NUMBERS HL AND BC 

EX DE,HL iSAVE HL VALUE IN DE 

CALL GHL ;GET 3RD ARGUMENT 

EX DE,HL ,-THIS GOES IN DE REGISTER 

RET ;WITH HL START ADDRESS 

CALL GHL ;GET 2 NUMBERS FIRST FOR HL 

EX DE,HL 

CALL GETl :GET LAST DATA IN BUFFER 
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020A 


3 821 


03430 




JE C,G2N3 


020C 


CCE302 


03440 


G2N0 


CALL Z.GET 


020F 


28FB 


03450 




JR Z,G2N0 


0211 


FE54 


03460 




CP 'T' 


0213 


280D 


03470 




JR Z,G2N1 


0215 


FD2B 


03480 




DEC lY 


0217 


CDE502 


03490 




CALL GETl 


021A 


C20003 


03500 




JP NZ, ERROR 


021D 


CD3202 


03510 




CALL GHL 


0220 


1807 


03520 




JR G2N2 


0222 


CD3202 


03530 


G2H1 


CALL GHL 


0225 


3F 


03540 




CCF 


0226 


ED52 


03550 




SBC HL,DE 


0228 


23 


03560 




INC HL 


0229 


44 


03570 


G2N2 


LD B,H 


022A 


4D 


03580 




LD C,L 


022B 


EB 


03590 




EX DE.HL 


022C 


C9 


03600 




RET 


022D 


214000 


03610 


G2N3 


LD HL,40H 


0230 


18P7 


03620 




JR G2N2 






03630 












03640 






GET VALID H 






03650 








0232 


210000 


03660 


GHL 


LD HL.OOOOH 


0235 


CDE302 


03670 


GBLO 


CALL GET 


0238 


28FB 


03680 




JR Z.GHLO 


023A 


CD4C02 


03690 




CALL VALHEX 


023D 


DA0003 


03700 




JP C, ERROR 


0240 


CD9701 


03710 


GHLl 


CALL LDHL 


0243 


CDE302 


03720 




CALL GET 


0246 


CD4C02 


03730 




CALL VALHEX 


0249 


30F5 


03740 




JR NCGHLl 


024B 


C9 


03750 




RET 






03760 












03770 












03780 






CHECK IF VA 






03790 








024C 


C6D0 


03800 


VALHEX 


ADD A.ODOH 


024E 


3F 


03810 




CCF 


024F 


D8 


03 820 




RET C 


0250 


FEOA 


03830 




CP OAH 


0252 


3F 


03840 




CCF 


0253 


DO 


03850 




RET NC 


0254 


C6P9 


03860 




ADD A,0F9H 


0256 


FEOA 


03870 




CP OAH 


0258 


D8 


03880 




RET C 


0259 


PEIO 


03890 




CP lOH 


025B 


3F 


03900 




CCF 


025C 


C9 


03910 
03920 
03930 
03940 




RET 

.-GET CHARACT 


025D 


E5 


03950 


GBYTE 


POSH HL 


025E 


CD6D02 


03960 




CALL CHKIN 


0261 


214740 


03970 




LD HL.OLD 


0264 


BE- 


03980 




CP (HL) 


.0265 


28F7 


03990 






3R Z,GBYTE+1 



FOR LONGEST INSTRUCTION 

EITHER COULD BE T 

SKIP SPACES 

THROUGH TILL LAST ADDRESS 

GO COMPUTE BLOCK LENGTH 

ADJUST POINTER 

LAST IN BUFFER 

ONLY VALID DELIMITERS 

GET BLOCK LENGTH 

GO STORE IN HL 

END ADDRESS MUST COMPOTE 

CLEAR FLAG 

;NEED ONE MORE 

; STORE LENGTH IN BC 

;PUT START ADDRESS BACK 

; MINIMUM LENGTH OF 40H 
; STORE IN BC 



: INITIALIZE TO ZERO 

SKIP SPACES 

CHECK FOR VALIDITY 

THIS MUST CLEAR BREAK POINTS 

SHIFT INTO HL PAIR 



;AND RETURN TO CALLING PROGRAM 



IF BETWEEN 30 AND 39 

AND 41 AND 47 CARRY GENERATED 

RETURN NOT VALID FLAG 

IF LESS THAN 10 VALID 

VALID RETURN IS NO CARRY 

BETWEEN AND 9 AND VALID 

IF BETWEEN 17 H AND 22H 

THIS WILL FLAG 

ERROR THOSE FEW 

:IF OVER OPH NO CARRY 
; RETURN WITH PROPER FLAG 



:WANT NEW CHARACTER 
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0267 
0268 
0269 
026B 
026C 
Q26D 
0270 
0271 
0272 
0273 
0276 
0277 
0279 
027B 
027E 
027F 
0281 
0282 



0283 
0286 
0289 
028A 
0286 
028D 
028F 
0290 
0293 
0294 
0295 
0296 
0298 
0299 
029B 
029D 
029F 
02A0 
02A1 
02A2 
02 A3 
Q2A4 
02 AS 
02A8 
02A9 
02AB 
02AD 
02AE 
02B0 
02B1 
02B3 



77 

B7 

28F3 

El 

C9 

3A7F38 

B7 

C8 

D9 

CD8302 

57 

0600 

lOFE 

CD8302 

BA 

20F2 

D9 

C9 



010000 

210138 

7E 

B7 

2008 

CB25 

03 

F28902 

AP 

C9 

IF 

3803 

04 

18FA 

CB75 

203C 

79 

07 

07 

07 

BO 

4F 

3A8038 

B7 

2802 

3E01 

47 

3E08 

BD 

3 80C 

3A4640 



02B6 Bl 
02B7 CB40 
02B9 2001 
Q2BB C9 



04000 

04010 

04020 

04030 

04040 

04050 CHKIN 

04060 

04070 

04080 

04090 TWO 

04100 

04110 

04120 Dl 

04130 

04140 

04150 

04160 

04170 

04180 

04190 

04200 

04210 KYDl 

04220 

04230 NEXT 

04240 

04250 

04260 

04270 

04280 

04290 

04300 

04310 HDATA 

04320 

04330 

04340 

04350 LOWBIT 

04360 

04370 

04380 

04390 

04400 

04410 

04420 

04430 

04440 

04450 

04460 

04470 NOSPT 

04480 

04490 

04500 

04510 

04520 

04530 

04540 

04550 

04560 



LD (HL) ,A 

OR A 

JR Z,GBYTE+1 

POP HL 

RET 

LD A, (387FH) 

OR A 

RET Z 

EXX 

CALL KYDl 

LD D,A 

LD B.OOH 

DJNZ Dl 

CALL KYDl 

CP D 

JR NZ,TWO 

EXX 

RET 

KEY SCAN 

LD BCOOQOH 

LD HL.3801H 

LD A, (HL) 

OR A 

JR NZ, HDATA 

SLA L 

INC BC 

JP P. NEXT 

XOR A 

RET 

RRA 

JR C, LOWBIT 

INC E 

JR HDATA 

BIT 6,L 

JR NZ,SPEC 

LD A,C 

RLCA 

RLCA 

RLCA 

OR B 

LD C,A 

LD A, (3880H) 

OR A 

JR Z,NOSFT 

LD A,01H 

LD B,A 

LD A,08H 

CP L 

JR CjNALPHA 

LD A,(OCFLAG) 

OR C 

BIT 0,B 

JR NZ,CAPIT 

RET 



;GET CHARACTER 

;SAVE 

; SHORT DELAY 



;IS IT THE SAME 
;NOT SAME TRY AGAIN 



:TURN ON BIT ZERO SCAN TO START 
:GET DATA 



;LINE 6 SPECIAL CHARACTERS 



:5 LSB HAVE LOVi DATA 
;IS SHIFT KEY PRESSED? 
iSHIFT KEY IN TWO PLACES 



: INFORMATION OF SHIFT IN B 

:IF CARRY NOT ALPHA CHAR 

i60H HERE IF LOWERCASE REQUIRED 
;OTHERWISE 40H FOR ONLY UPPERCASE 

;WAS SHIFT PRESSED 
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02BC 
02BE 
02BF 
02C1 
02C3 
02C5 
02C6 
02C8 
02CA 
02CB 
02CD 
02CE 
02D1 
02D3 
02D5 
02D6 
02D8 
02D9 
02DB 
02DE 
02DF 
02E0 
02E1 
02E2 



CBAF 

C9 

CB6D 

200B 

3E30 

Bl 

CB40 

2001 

C9 

CBA7 

C9 

3A2038 

FEIO 

3 8EE 

78 

EEOl 

47 

18E8 

213B00 

78 

85 

6F 

7E 

C9 



02E3 FD23 
02E5 FD7E00 
02Ee FEOl 
02EA CA6C00 
02ED FE20 
02EF C8 
02F0 FE2C 
02F2 CO 
02P3 B7 
02F4 37 
02F5 D8 



02F6 
02F8 
02FB 
02FD 
0300 
0302 
0305 
0308 
030A 
030C 
030F 
0312 
0315 
0317 
0319 



FD23 

CDE502 

28F9 

DABOOO 

3E3F 

FD7700 

CDE302 

3802 

18F9 

218040 

CD8D01 

CD0701 

3E00 

D3EC 

18DD 



04570 
04580 
04590 
04600 
04610 
04620 
04630 
04640 
04650 
04660 
04670 
04680 
04690 
04700 
04710 
04720 
04730 
04740 
04750 
04760 
04770 
04780 
04790 
04800 
04810 
04820 
04830 
04840 
04850 
04860 
04870 
04880 
04890 
04900 
04910 
04920 
04930 
04940 
04950 
04960 
04970 
04980 
04990 
05000 
05010 
05020 
05030 
05040 
05050 
05060 
05070 
05080 
05090 
05100 
05110 
05120 
05130 



CAP IT 

NALPHA 

NALPHl 

CHAR 
N0T7 



GET 
GETl 



CONTIl 
CONTIN 



ERROR 
ERO 



TOFFl 
ER2 



;AC HAS UPPER CASE DATA 



:THIS IS NOW CHARACTER 



RES 5, A 

RET 

BIT 5,1, 

JR NZ,N0T7 

LD A,30H 

OR C 

BIT 0,B 

JR NZ,CHAR 

RET 

RES 4 ,A 

RET 

LD A, (3820H) 

CP lOH 

JR C, NALPHl 

LD A,B 

XOR OIH 

LD B,A 

JR NALPHl 

LD HL, TABLE 

LD A,B 

ADD A,L 

LD L,A 

LD A, (HL) 

RET 



GET FETCHES NEXT DATA IN INPUT STRING 

BY INC FIRST lY WILL ALWAYS POINT TO LAST VALUE 



: TABLE MUST BE LOCATED 

;SUCH THAT THE FOLLOWING ADDITION 

:DOES NOT CROSS BOUNDRIES 



INC lY 

LD A, (lY+OH) 

CP QIH 

JP Z.COMAND 

CP 20H 

RET Z 

CP ' , ' 

RET NZ 

OR A 

SCF 

RET C 

INC lY 
CALL GETl 
JR 2, CONTIl 
JP CCHND 
LD A,'?i 
LD (IY+0) ,A 
CALL GET 
JR CERl 
JR ERO 

LD HL, BUFFER 
CALL PHSG 
CALL CLRBP 
LD A,OOH 
OUT (OECH) ,A 
JR CONTIN 

: COMMAND TABLE 



ENTER HERE FOR LAST ENTRY 

BREAK? 

START ALL OVER 

SPACE SET ZERO FLAG 

FLAG SPACES 

IF COMMA SET CARRY 

ALL OTHERS RETURN 

NO ZERO 

SET CARRY 



NEXT 

LAST CHARACTER IN STRING 

SKIP TRAILING SPACES 

FINISH OLD OR BACK TO BEGIN 

SHOW AT END 

SHOW IT 

adjust buffer 

want next comma 

out only with true comma 

odh starts this line 

output buffer text to error 

clear breakpoints 

tall set 

; continue with buffer 



ji\ 
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031B A503 
031D 5103 
031F 6803 
0321 EDOl 
0323 9203 
0325 C703 
0327 C307 
0329 B403 
032B 6D04 
a32D C404 
032F 0003 
0331 0003 
0333 A104 
0335 AC04 
0337 8204 
033 9 BA04 
033B 1B40 
033D BF07 
033F 1107 
0341 E704 
03 43 B403 
0345 1E40 
0347 3405 
0349 5906 
034B 5305 
034D 0003 
034F AF03 



0351 
0354 
0356 
0359 
03 5C 
035D 
0360 
0362 
0363 
0364 
0366 



CD0302 

1620 

CD8001 

CDA201 

7E 

CDB201 

EDAl 

EO 

15 

2aEE 

18F4 



0368 CDE302 
036B DA8103 
036E FE53 
0370 2801 

0372 C9 

0373 21B040 
0376 010001 
0379 118041 
037C EDBO 



05140 

05150 COHTAB 

05160 

05170 

05180 

05190 

05200 

05210 

05220 

05230 

05240 

05250 

05260 

05270 

0528O 

05290 

05300 

05310 

05320 

05330 

05340 

05350 

05360 

05370 

05380 

05390 

05400 

05410 

05420 

05430 

05440 

05450 

05460 

05470 

05480 ASCII 

05490 ASCIll 

05500 

05510 

05520 ASCII2 

05530 ASCII4 

05540 

05550 

05560 

05570 

05580 

05590 

05600 

05610 

05620 BUPFR 

05630 

05640 

05650 

05660 

05670 SAVE 

05680 

05690 

05700 



DEFW FILL ;FILL ADDRESS SPACE WITH CONSTANT 

DEFW ASCII ; ADDRESS OF ROUTINE 

DEFW BUFFR ;ADDRESS OF BUFFER PROGRAM 

DEFW CLEARS iCLEAR SCREEN WITH 20H 

DEFW DISPLY ;ADDRESS OP ROUTINE 

DEFW GO ; EXECUTE WITH CURRENT SCREEN 

DEFW FINDON : SEARCH FOR SINGLE BYTE 

DEFW ENTER [EXECUTE WITH OLD SCREEN DATA 

DEFW HEXH ; ADDRESS OF HEXM 

DEFW SUBSM : INSERT FROM BUFFER 

DEFW ERROR ;J 

DEFW ERROR ;K 

DEFW LIST ;TOGGLE HARDCOPY SWITCH 

DEFW HOVE ;ADDRESS OF MOVE 

DEFW IN ; INPUT FROM PORT 

DEFW OUT ; OUTPUT TO PORT 

DEFW PROH ;PROM PROGRAMMER 

DEFW PINDTO ; SEARCH FOR TWO BYTE INTEL FORMAT 

DEFW READ ;READ A CASSETTE TAPE WITH BIAS 

DEFW INSERT ;DATA FROM KEYBOARD 

DEFW ENTER ; TRANSFER FROM SCREEN TO VIDEO 

DEFW USER :USER ROUTINE 

DEFW VERIFY lADDRESS OF VERIFY 

DEFW WRIT ;WRITE A TAPE ON CASSETTE 

DEFW EXAM ; ADDRESS 
DEFW ERROR 

DEFW STEP ; SINGLE STEP IF HARDWARE ADDED 
:WITH OLD SCREEN DATA 

; COMMAND SUBROUTINES 

rDISPLAY IN ASCII FORMAT WITH GRAPHICS 

CALL G2N :GET ARGUMENTS 

LD D,3 2D ;56 DECIMAL POSITIONS MAX 

CALL ADDR ; PRINT LOCATION OF BEGINNING LINE 

CALL SPACE : SPACE 

LD A,(HL) :GET DATA 

CALL CRT 

CPI fASCII DUMP FINISHED? 

RET PO jCHANGE LATER FOR STRING 

DEC D [FINISHED WITH LINE? 

JR Z, ASCIll :NOT FINISHED WITH LINE 

JR ASC112 ;NOT FINISHED 



BUFFER SAVE' AND EXECUTE ROUTINES 



CALL GET 

JP CTRAN 

CP 'S' 

JR Z,SAVE 

RET 

LD HL, BUFFER 

LD BCIOOH 

LD DE.TEM 

LDIR 



;GET NEXT DATA 
rTRANSFER SAVED BUFFER 
;SAVE BUFFER 
[IGNORE ALL ELSE 
[CONTINUE AND IGNORE 
[BUFFER BEGINNING 
; PLENTY 

[PLACE TO SAVE 
[TRANSFER COMMAND TEXT 
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037E 


FD23 


05710 


INC lY 


BYPASS THE S FOR CONTIN 


0380 


C9 


05720 


RET 




0381 


218041 


05730 


TRAN LD HL,TEM 




0384 


010001 


05740 


LD BCIOOH 


ONE PAGE OF BUFFER 


03 87 


118040 


05750 


LD DE, BUFFER 




03 8A 


D5 


05760 


PUSH DE 




03 86 


PDEl 


05770 


POP lY 




03 8D 


EDBO 


05780 


LDIR 




03 BF 


C38A00 


05790 


JP CD 


QUICK WAY TO LOAD BUFFER 






05800 












05810 












05820 




DISPLAY IN HEX-FORMAT 






05830 








0392 


CD03C2 


05840 


DISPLY CALL G2N 


GET ARGUMENTS 


0395 


CD8001 


05850 


DISPl CALL ADDR 


PRINT MEM ADDRESS 


0398 


CD5C01 


05860 


DISP2 CALL SPCHL 


SPACE FOLLOWED BY HEX DATA 


03 9B 


EDAl 


05870 


CPI 


INCREMENT POINTERS 


03 9D 


EO 


05880 


RET PO 


BC=0 THEN DONE 


039E 


7D 


05890 


LD A,L 


GET ADDRESS OF HEM 


03 9F 


E60F 


05900 


AND OFH 


MASK ALL BUT LOW 


OSAl 


28F2 


05910 


JR Z, DISPl 


NEXT LINE 


03A3 


18F3 


05920 


JR DISP2 


GO FINISH LINE 






05930 












05940 












05950 












05960 




FILL MEMORY VflTH CONSTANT 






05970 








03A5 


CDF AC 1 


05980 


FILL < 


:ALL G3N 


GET 3 ARGUMENTS, WHERE. 


03A8 


7B 


05990 




jD A,E 


HOW MANY AND WHAT 


03A9 


77 


06000 


FILLl 


M (HL) ,A 


DO IT 


03AA 


EDAl 


06010 


( 


:pi 


INCREMENT POINTERS 


03AC 


EO 


06020 




?ET PO 


FINISHED? 


03AD 


-18FA 


06030 
06040 
06050 




IR FlLLl 


CONTINUE 






06060 




SINGLE STEP EXECUTE WITH LAST SCREEN DATA 


03AF 


3E01 


06070 


STEP I 


jD a, 01 


SINGLE STEP FLAG 


03B1 


.324240 


06080 
06090 




jD (SSFLAG) ,A 


STORE AND FALL INTO GO 


03B4 


2A3E40 


06100 


ENTER I 


jD HL, (SCREEN) 


CURRENT SCREEN STORAGE 


03 B7 


11003C 


06110 




^D DE,3C00H 


TO BE PLACED HERE 


03 BA 


010004 


06120 




jD BC,0400H 


ALL 1024 OF THEM 


03BD 


EDBO 


06130 




jDIR 


DOES IT 


03BF 


CDE502 


06140 




:aLL GETl 


LAST IN STRING 


03C2 


FE54 


06150 




;p 'T' 


TRANSFER IS ALL THAT IS 


03C4 


CA6F00 


06160 
06170 




JP ZrCOHl 


■REQUIRED THEN RETURN NO PR 






06180 




GET PC AND EXEC 


JTE WITHOUT SCREEN 






06190 




IF ENTERED AT G 


3 






06200 












06210 








03C7 


0600 


06220 


GO 


jD B,00H 


BREAK COUNTER 


03C9 


FD23 


06230 




tKC lY 


ADJUST BUFFER 


03CB 


211240 


06240 




..D HL.HSTLOC 




03CE 


36C3 


06250 




jD (HL) .0C3H 


PUT JUMP THERE 


03D0 


21A600 


06260 




jD HL.RSAVE 


ADDRESS FOR JUMP 


03D3 


221340 


06 27 




uD (RSTLOC+1) ,HL 


ADDRESS 
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03D6 

03D9 

03DC 

03DF 

03E1 

03E3 

03E5 

03 E7 

03E9 

03 EC 

03 EF 

03F1 

03F4 

03F6 

03F8 

03FA 

03FC 

03FE 

0401 

0402 

0403 

0404 

0406 

0407 

0408 

0409 

040C 

040E 

0411 

0412 

0415 

0416 

0418 

041B 

041C 

041F 

0420 

0422 

0424 

0428 

042B 

042E 

0431 

0434 

0437 

043A 

043D 

043F 

0441 

0442 

0444 

0446 

0447 

0448 

0449 

044A 

044B 



318040 

CDE502 

CCE302 

28FB 

3841 

FE2E 

280A 

FD2B 

CD3202 

223C40 

IBEB 

CDE302 

FE2B 

2816 

FE2D 

281C 

FD2B 

CD3202 

7E 

ES 

F5 

3EFF 

77 

04 

78 

324540 

18CB 

CD3202 

EB 

2A3C40 

19 

18E9 

CD3202 

EB 

2A3C40 

B7 

ED52 

18DD 

FD224840 

21FBD3 

22A042 

2100C3 

22A242 

2A3C40 

22A442 

312640 

DDEl 

PDEl 

Fl 

ED47 

3001 

FB 

Fl 

CI 

Dl 

El 

D9 



GOl 
G02 



06280 

06290 

06300 

06310 

06320 

06330 

06340 

06350 

06360 

06370 

06380 

06390 BREAK 

06400 

06410 

06420 

06430 

06440 

06450 

06460 BREAKl 

06470 

06480 

06490 

06500 

06510 

06520 

06530 

06540 

06550 PLUS 

06560 

06570 

06580 

06590 

06600 MINUS 

06610 

06620 

06630 

06640 

06650 

0666C 

06670 

06680 

06690 

06700 

06710 

06720 

06730 

06740 

06750 

06760 

06770 

06780 

06790 

06800 

06810 

06820 

06830 

06 840 



LDREG 



HL 



G04 



LD SP, BREAKS 

CALL GETl 

CALL Z.GET 

JR Z,G02 

JR C, LDREG 

CP ' .' 

JR Z, BREAK 

DEC lY 

CALL GHL 

LD (PCSAVE) 

JR GOl 

CALL GET 

CP ' + ' 

JR Z,PLUS 

CP '-' 

JR Z, MINUS 

DEC lY 

CALL GHL 

LD A,(HLJ 

PUSH HL 

PUSH AF 

LD A.RST 

LD (HL) ,A 

INC B 

LD A,B 

LD (BPNO),A 

JR GOl 

CALL GHL 

EX DE,HL 

LD HL, (PCSAVE) 

ADD HL.DE 

JR BREAKl 

CALL GHL 

EX DE.HL 

LD HL, (PCSAVE) 

OR A 

SBC HL.DE 

JR BREAKl 

LD (EPOINT) ,iy 

LD HL,0D3FBH 

LD (JHPl ,HL 

LD HL,0C3OOH 

LD (JHP+2) ,HL 

LD HL, (PCSAVE) 

LD (JMP+4),HL 

LD SP.BOTHS 

POP IX 

POP IV 

POP AF 

LD I, A 

JR NC,G04 

EI 

POP AF 

POP BC 

POP DE 

POP HL 

EXX 



IBREAKSTACK 

;NEXT DATA IN BUFFER 

;NEXT IN BUFFER 

:USE STORED PC 

; BREAKPOINT? 

;IT IS A BREAK 

JADJUST FOR 1ST DIGIT OF ADDE 

; START OR BREAK 

;MEW PC 

? CONTINUE 

,-NEXT CHARACTER 

; RELATIVE JUMP 



NO RELATIVE JUMP 

GET ABSOLUTE VALUE 

GET CODE AT ADDRESS 

SAVE ADDRESS 

SAVE DATA 

RESTART ,THS-80 USES 7 FOR TIME 

SAVE IT AS BREAK 

BREAK COUNTER 

SAVE 

CONTINUE 

GET RELATIVE VALUE 

SAVE IN DE 

PROGRAM COUNTER 

BREAKPOINT COMPUTED 

;GET RELATIVE VALUE 



; CLEAR CARRY 

; RELATIVE JUMP COMPUTED 

iSAVE BUFFER POINTER AT BPOINT 

; ENABLE INTERRUPT AND OUT 

IPORT AND JUMP 

; EXECUTE ADDRESS 
rADDRESS IN PLACE 
; REGISTER DATA 

RESTORE IX AND lY 
INTERRUPT INFORMATION 
LOAD INTERRUPT VECTOR 
IP CARRY NO INTERRUPTS 
INTERRUPTS REQUESTED 
THIS TIME IT IS AF ' 



r PRIMES IN PLACE 
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044C 
044D 
044E 
044F 
0450 
0453 
0454 
0457 
0458 
045B 
045C 
04SE 
0460 
0462 
0463 



08 

Fl 

CI 

Dl 

2A2440 

F9 

2A3A40 

F5 

3A4240 

B7 

280B 

3E08 

D3E0 

07 

D3EC 



0465 Fl 

0466 C3A042 
0469 Fl 
046A C3A342 



046D 
0470 
0471 
0474 
0475 
0476 
0479 
047A 
047B 
047C 
047E 
0481 



0482 
0485 
0486 
0487 
0488 
048B 
048E 
0491 
0493 
0496 
0499 
049C 
049D 
049E 
049F 



CD3202 

EB 

CD3202 

E5 

19 

CD83ai 

El 

EB 

AF 

ED52 

CD7 901 

C9 



CD0302 

41 

4D 

79 

CD6001 

CD8601 

CDA201 

ED7 8 

CD6001 

CDA201 

CDA201 

05 

C8 

DC 

18E6 



06850 

06860 

06870 

06880 

06890 

06900 

06910 

06920 

06930 

06940 

06950 

06960 

06970 

06980 

06990 

07000 

07010 

07020 

07030 

07040 

07050 POPAF 

07060 

07070 

07080 

07090 

07100 HEXM 

07110 

07120 

07130 

07140 

07150 

07160 

07170 

07180 

07190 

07200 

07210 

07220 

07230 

07240 

07250 

07260 

07270 

07280 INNEXT 

07290 

07300 

07310 

07320 

07330 

07340 

07350 

07360 

07370 

07380 

07390 

07400 

07410 LIST 



IN 



EX AF.AF' 

POP AF 

POP BC 

POP DE 

LD HL, (SSTACK) 

LD SP,HL 

LD HL, (HLSAVE) 

PUSH AF 

LD A, (SSFLAG) 

OR A 

JR Z, POPAF 

LD A,08H 

OUT (OEOH) ,A 

RLCA 

OUT (OECH) ,A 



;NOW SWITCH 



GET SYSTEM STACK POINTER 

STACK IN PLACE 

HL OK 

SAVE AF ON USER STACK 

SINGLE STEP? 

TEST 

IF ZERO NO SINGLE STEP 

ENABLE INTERRUPT FROM EXTERNAL BUS 

USING PORT EOH 

08 BECOMES 10 WHICH ENABLES 

ADDRESS, DATA, AND CONTROL LINES 



WITH HARDWARE TO COUNT OUT TO PRODUCE INTERRUPT 



POP AF 
JP JHP 
POP AF 
JP JMP+3 



: RESTORE REGISTERS 

;SET SHIFT REGISTER FOB SINGLE STEP 

; RESTORE REGISTERS 

: EXECUTE BYPASSING STEP INTERRUPT 



HEX MATH FIRST SUM THEN DIFFERENCE 



CALL GHL 
EX DE,HL 
CALL GHL 
PUSH HL 
ADD HL.DE 
CALL ADDRl 
POP HL 
EX DE.HL 
XOR A 
SBC HL,DE 
CALL PNHL 
RET 



:GET ARGUMENTS 

2ND ARGUMENT 

SAVE 2ND ARGUMENT 

GET SUM 

NUMBER FOLLOWED BY : 

GET 2ND BACK 

PUT IN PROPER ORDER 

CLEAR BORROW FLAG 

GET DIFFERENCE 

DISPLAY SECOND NUMBER 

FINISHED 



INPUT FROM PORT XX AND DISPLAY 



CALL G2N 
LD B,C 
LD C,L 
LD A,C 
CALL PHEX 
CALL ADDR2 
CALL SPACE 
IN A. (C) 
CALL PHEX 
CALL SPACE 
CALL SPACE 
DEC B 
RET Z 
INC C 
JR INNEXT 

INC lY 



GET PORT DESIRED 

NUMBER OF INPUT PORTS IN SEQUENCE 

C HAS PORT TO INPUT 

A GETS PORT NUMBER 

OUTPUT PORT NUMBER 

OUTPUT A : 

;GET DATA 

: OUTPUT DATA 

: SPACE 

;ALL PORTS INPUT 
lYES COMMAND STRING 
;NEXT PORT 



: ADJUST POINTER 
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04A3 3A4A40 


07420 




LD A, (PRNTFG) 


04A6 EEOl 


07 430 




XOR 01 H 


04A8 324A40 


07440 




LD (PRNTFG) ,A 


04AB C9 


C7450 
07460 




RET 




07470 




;MOVE MEMORY 




07480 






04AC CDFAOl 


07490 


HOVE 


CALL G3N 


04AF E5 


07500 


MOVl 


PUSH HL 


04B0 D5 


07510 




PUSH DE 


04B1 C5 


07520 




PUSH EC 


04B2 EDBO 


07530 




LDIR 


04B4 CI - 


07540 




POP BC 


04BS Dl 


07550 




POP DE 


04B6 El 


07 560 




POP HL 


04B7 C33705 


07570 
07580 




JP VERIFl 




07590 




; OUTPUT HEX DATA 




07600 






04BA CD3202 


07610 


OUT 


CALL OHL 


04BD 4D 


07620 




LD C,L 


04BE CD3202 


07630 




CALL GHL 


4C1 ED69 


07640 




OUT (C) ,L 


04C3 C9 


07650 
07660 




RET 




07670 




; SUBSTITUTE MEMOf 




07680 






04C4 CD3202 


07690 


SUBSM 


CALL GHL ; 


04C7 CD8001 


07700 


SUBS 


CALL ADDR : 


04CA E5 


07710 


SOBSl 


PUSH HL ; 


04CB CD3202 


07720 




CALL GHL ; 


04CE CDE502 


07730 




CALL GETl ; 


04D1 FE2F 


07740 




CP '/' : 


04D3 280D 


07750 




JR Z, NEWADl ': 


04D5 7D 


07760 


SUBS3 


LD A,L 


04D6 El 


07770 




POP HL ; 


04D7 77 


07780 




LD (HL) ,A ; 


04D8 CD5C01 


077 90 




CALL SPCHL : 


04DB 23 


07800 




INC HL ; 


04DC CDE502 


07810 




CALL GETl ; 


04DF D8 


07820 




RET C ; 


04E0 18E8 


07830 




JR SUBSl ; 


04E2 FD23 


07840 


NEWADl 


INC lY : 


04E4 Dl 


07850 


NEKADR 


POP DE ; 


04ES 18E0 


07860 




JR SUBS : 


04E7 CD3202 


07 870 


IMSERT 


CALL GHL : 


04EA CD8001 


07880 


INSl 


CALL ADDR 


04ED CD5C01 


07890 


INS2 


CALL SPCHL ; 


04F0 E5 


07900 




PUSH HL ; 


04F1 210000 


07910 




LD HL,00H : 


04F4 0601 


07920 




LD B,01H : 


04F6 3E3F 


07930 


PRINIT 


LD A, '?' ; 


04F8 CDB201 


07940 




CALL CRT ; 


04FB CD5D02 


07950 


1NS3 


CALL GBYTE 


04FE FEOD 


07 96 




CP ODH : 


0500 282E 


07970 




JR Z, FIRST 


0502 FE08 


07980 




CP 08H ; 



GET CURRENT FLAG 
TOGGLE TO OPPOSITE STATE 
RETURN TO STORAGE 
CONTINUE STRING 



iGET ARGUMENTS OF FROM 
:HOW MUCH AND TO 

iSAVE ARGUMENTS FOR VERIFY 
■ONE OF THOSE NICE Z-80 CODES 
: RESTORE 

: RESTORED NOW 
rJUHP TO VERIFY 



:GET PORT NUMBER 
;PORT MUST BE IN C 
;GET DATA 
; OUTPUT 
^FINISHED 



GET ADDRESS 

PRINT IT 

SAVE IT 

GET NUMBER IN HL 

LAST IN STRING 

ADDRESS OR DATA 

IT IS ADJUST STACK AND lY 

ONLY L USED 

GET ADDRESS 

STORE 

SHOW US 

NEXT FORWARD POSITION 

LAST STRING ENTRY 

WAY OUT 

CONTINUE INSERTION OF DATA 

ADJUST lY 

DON'T DESTROY NEW ADDRESS 

PRINT NEW ADDRESS 

GET ADDRESS 

SPACE FOLLOWED BY DATA 

SAVE ADDRESS 

CLEAR DATA 

COUNT 

PROMPT FOR SUBSTITUTE KEYBOARD 

SHOW WE ARE LOOKING FOR DATA 

DATA FROM KEYBOARD 

ENTER? 



GO BACK 



171 



0504 2826 


07990 




JR Z, BACKW 


IRETORN PRINT ADDRESS 


0505 FE20 


08000 




CP 20H 


!WILL NOT ALTER DATA 


0508 2813 


08010 




JR Z,INCK 


; INCREMENT AND KEEP 


050A CDB201 


08020 




CALL CRT 




050D FE2F 


08030 




CP '/' 


:NEW ADDRESS 


050F 2818 


08040 




JR Z, NADDS 


;LAST STRING WAS ADDRESS 


0511 CD4ca2 


08050 




CALL VALHEX 


;IS IT HEX 


0514 38E0 


08060 




JR C.PRIHIT 


.:TRY AGAIN 


0516 04 


8070 




INC B 




0517 CD9701 


08080 




CALL LDHL 


; SHIFT INTO HL PAIR 


051A C3FB04 


08090 




JP INS3 




051D El 


08100 


INCK 


POP HL 


;GET OLD ADDRESS 


051E 1803 


08110 




JR ENTl 




0520 7D 


08120 


ENT 


LD A,L 


;ONLY INFO IN L REQUIRED 


0521 El 


08130 




POP HL 




0522 77 


08140 




LD (HL) .A 




0523 CD5C01 


08150 


ENTl 


CALL SPCHL 


: SPACE FOLLOWED BY DATA 


0526 23 


08160 




INC HL 




0527 18C1 


08170 




JR INSl 




0529 Dl 


08180 


NADDS 


POP DE 




052A 18BE 


08190 




JR INSl 




052C El 


08200 


BACKW 


POP HL 




052D 2B 


08210 




DEC HL 




052E 18BA 


08220 




JR INSl 


; PRINT LAST ADDRESS 


0530 lOEE 


08230 


FIRST 


DJNZ ENT 




0532 El 


08240 




POP HL 




0533 C9 


08250 
08260 
08270 
08280 




RET 

iVERIPY MEMORY 




0534 CDFflOl 


08290 


VERIFY 


CALL G3N 


;GET ARGUMENTS 


0537 lA 


08300 


VERIFl 


LD A, (DE) 




053 8 EDAl 


08310 




CPI 




053A 2813 


08320 




JR Z,VERF2 


; AGREES SO CONTINUE 


053C 2B 


08330 




DEC HL 


:G0 BACK FOR DISPLAY 


053D CD8001 


08340 




CALL ADDR 


lADDRESS 


0540 CD5C01 


08350 




CALL SPCHL 


:AND DATA AT ADDRESS 


0543 EB 


08360 




EX DE,HL 


:N0W OTHER 


0544 CDA201 


08370 




CALL SPACE 


; SPACE 


0547 CD8301 


08380 




CALL ADDRl 


; ADDRESS BUT NOT NEW LINE 


054A CDSCOl 


08390 




CALL SPCHL 


IDATA AT OTHER ADDRESS 


054D EB 


08400 




EX DE.HL 


; RESTORE 


054E 23 


08410 




INC HL 


r RESTORE HL 


054F 13 


08420 


VERF2 


INC DE 


rINC OTHER POINTER 


0550 EC 


08430 




RET PO 


: FINISHED? 


0551 18E4 


08440 
08450 
08460 




JR VERIFl 


: CONTINUE 


0553 CDE302 


08470 


EXAM 


CALL GET 


;NEXT IN STRING 


0556 28FB 


08480 




JR Z.EXAM 




0558 3821 


08490 




JR CXALL 


;IF C, EXAMINE ALL 


055A F5 


08500 




PUSH AF 


;SAVE 


a55B CDE302 


08510 




CALL GET 


; PRIME OR NOT 


055E D627 


08520 




SUB ' " 


!lF PRIME STORE OIH IN PRIME 


0560 2804 


08530 




JR Z,EXAM2 


;N0 NEED TO CORRECT POINTER 


0562 PD2B 


08540 




DEC lY 


.■ADJUST BUFFER POINTER 


0564 3EPP 


08550 




LD A,OPFH 


IWHEN INC WILL BE 
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0566 


3C 


08560 EXAM2 


INC A ; 


0567 


324B40 


08570 


LD (PRIME! ,A ; 


056A 


Fl 


8580 EXAM3 


POP AF : 


056B 


213906 


08590 


LD HL,XTAB 


056E 


012000 


08600 


LD BC,32D ; 


0571 


EDAl 


08610 COMTCP 


CPI : 


0573 


CA0606 


08620 


JP Z, POUND 


0576 


E20003 


08630 


JP PO, ERROR ; 


0579 


18F6 


08640 


JR CONTCP ; 


057B 


AF 


08650 XALL 


XOR A 


057C 


324B40 


08660 


LD (PRIMF) ,A ; 


057F 


215706 


08670 


LD HL,PCP ; 


0582 


CDBB05 


86 80 


CALL PVAL ; 


0585 


CDA201 


08690 


CALL SPACE 


0588 


213906 


08700 


LD HL.XTAB : 


058B 


0606 


08710 


LD B,6H : 


058D 


CDAEDS 


08720 


CALL ALLl ; 


0590 


0609 


08730 ALL3 


LD B,9H : 


0592 


CD9E01 


08740 


CALL NEKLIN 


0595 


CDAE05 


08750 


CALL ALLl 


0598 


E5 


08760 


PUSH HL 


0599 


C5 


08770 


PUSH BC 


059A 


CDEF05 


08780 


CALL FLAGP : 


059D 


CI 


087 90 


POP BC 


059E 


El 


08800 


POP HL 


059F 


3A4B40 


08810 


LD A, (PRIHFl 


05A2 


3C 


08820 


INC A 


05 A3 


324B40 


08830 


LD (PRIKF) ,A 


05A6 


FE02 


08840 


CP 02H 


05A8 


C8 


08850 


RET Z 


05A9 


214506 


08860 


LD HL,RA 


05 AC 


ieE2 


08870 


JR ALL3 


05AE 


C5 


08880 ALLl 


PUSH BC 


05AF 


CDBB0 5 


08890 


CALL PVAL ; 


05B2 


F5 


08900 


PUSH AF 


05B3 


CDA201 


08910 


CALL SPACE 


05B6 


Fl 


08920 


POP AF 


05B7 


CI 


08930 


POP BC 


05B8 


10F4 


08940 


DJNZ ALLl ; 


05BA 


C9 


08950 


RET 


05BB 


46 


08960 PVAL 


LD B, (HL) ; 


05BC 


23 


08970 


INC HL : 


05BD 


7E 


08980 


LD A,(HL) ; 


05BE 


112440 


08990 PVALl 


LD DE,SSTACK 


05C1 


83 


09000 


ADD A,E 


05C2 


SF 


09010 


LD E,A 


05C3 


7A 


09020 


LD A,D ; 


05C4 


CBOO 


09030 


ADC A,OOH ; 


05C6 


57 


09040 


LD D,A : 


05C7 


23 


09050 


INC HL ; 


05C8 


78 


09060 


LD A,B : 


05C9 


CDB201 


09070 


CALL CRT 


5CC 


3A4B40 


09080 


LD A, (PRIMF) 


05CF 


B7 


09090 


OR A 


05DO 


2808 


09100 


JR Z,NPRIK 


05D2 


7B 


09110 


LD A,E 


05D3 


D608 


09120 


SUB 8H 



IT IS NOW 01 H 

FLAG REFLECTS PRIME REGISTER 

GET REGISTER NAME 

32 CHARACTERS AND DATA LOCATIONS 
COMPARE (HL) TO A AND INC 

NOT IN TABLE 

CONTINUE COMPARISON 

CLEAR A 

MUST BE ZERO 

PROGRAM COUNTER IN XTAB 

PRINT 'P' AND CONTENTS OF PC 

REGISTER TABLE 
REST OF REGISTERS 
DISPLAY S,IX,IY,N,I,V 
NINE REGISTER DATA DISPLAY 



PRINT FLAG DATA 



PRINT NAME AND VALUE 



REST OF REGISTERS 



HL POINTS TO REG NAME 

POINT TO BIAS 

SIGN VIILL HAVE DATA AS TO 1 OR 



GET HIGH ORDER 
PAGE BOUNDARY 
DOUBLE BYTE ADD 
POINT TO NEXT ENTRY 
PRINT NAME 
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05D5 


5F 


09130 




LD E,A 


05D6 


3E27 


09140 




LD A, ' ' ' 


0SD8 


1802 


09150 




JR PRIME 


05DA 


3E3D 


09160 


NPRIM 


LD A,'=' 


05DC 


CDB201 


09170 


PRIME 


CALL CRT 


05DF 


CB7B 


9180 




BIT 7,E ; 


05E1 


2807 


09190 




JR Z.ONEB : 


05E3 


CBBB 


09200 




RES 7,E ; 


05E5 


lA 


09210 




LD A, (DE) ; 


05B6 


CD6001 


09220 




CALL PHEX ; 


05E9 


IB 


09230 




DEC DE ; 


05EA 


lA 


09240 


ONEB 


LD A, (DE) 


05EB 


CD6001 


09250 




CALL PHEX 


05EE 


C9 


09260 




RET 


05EF 


47 


09270 


FLAGP 


LD B,A 


05F0 


CDA201 


09280 




CALL SPACE 


05F3 


213106 


09290 




LD HL.FTAB 


05F6 


CB20 


09300 


FLAGl 


SLA B 


05F8 


3 805 


09310 




JR C, OFLAG 


05FA 


C8 


09320 




RET Z 


05FB 


3E20 


09330 




LD A,20H 


05FD 


1801 


093 40 




JR FLAG2 


05FF 


7E 


09350 


OFLAG 


LD A, (HL) 


0600 


CDB201 


09360 


FLAG2 


CALL CRT 


0603 


23 


09370 




INC HL 


0604 


18F0 


09380 




JR FLAGl 


0606 


4E 


09390 


FOUND 


LD C. (HL) ; 


0607 


47 


09400 




LD B,A : 


0608 


79 


09410 




LD A,C ; 


0609 


CDBEDS 


09420 




CALL PVALl ; 


06 OC 


CDE302 


09430 


FOUNDl 


CALL GET r 


060F 


3811 


09440 




JR C, NOTTWO ; 


0611 


28F9 


09450 




JR Z. FOUNDl ; 


0613 


FD2B 


09460 




DEC lY 


0615 


CD3202 


09470 




CALL GHL ; 


0618 


7D 


09480 




LD A,L ; 


06191 


12 


09490 




LD (DE) ,A ; 


061A 


79 


09500 




LD A,C ; 


061B 


B7 


09510 




OR A : 


061C 


F22206 


09520 




JP P, NOTTWO ; 


061F 


13 


09530 




INC DE 


0620 


7C 


09540 




LD A,H ; 


06 21 


12 


09550 




LD (DE) ,A 


0622 


CDA201 


09560 


NOTTWO 


CALL SPACE 


0625 


79 


09570 




LD A.C ; 


06 26 


CDBE05 


09580 




CALL PVALl 


0629 


4F 


09590 




LD C,A : 


06 2A 


78 


09600 




LD A,B : 


06 2B 


FE46 


09610 




CP 'F' : 


062D 


79 


09620 




LD A.C : 


062E 


2 8BF 


09630 




JR Z, FLAGP 


0630 


C9 


09640 




RET ; 


0631 


53 


09650 


FTAB 


DEFH 'SZXHX/NC 


0639 


53 


09660 


XTAB 


DEFM 'S' 


063A 


81 


09670 




DEFB 81H 


063B 


58 


09680 




DEFM 'X' 


063C 


83 


9690 




DEFB 83H 



CHECK FOR ONE OR TWO BYTE NUMBER 

NO ADJUST IF ONE BYTE 
TWO BYTE, CORRECT BIAS 
GET VALUE 
PRINT IT 

DECREMENT POINTER 
GET VALUE 



SAVE BIAS AND NUMBER OF BYTES 

B REGISTER GETS NAME 

BIAS INTO AC 

WRITE FORMER CONTENTS 

DATA TO REPLACE OR END 

PRINT NEW DATA 

SKIP BLANK (20H) 

ADJUST BUFFER POINTER GHL WANTS 

VALID HEX IN FIRST POSITION 

MOVE TO STACK 

IF ONLY ONE ITS IN L 

SIGN HAS 1,2 INFORMATION 

SET FLAG 

IF POSITIVE ONLY ONE BYTE 

GET HIGH DATA 



GET REGISTER INFORMATION 

DATA LAST PRINTED INTO C 

CHECK FOR FLAG 

IF FLAG PRINT FLAGS 

DATA BACK TO A FOR FLAG PRINT 

RETURN TO STRING PROCESS 



*i5'|^ 
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063D 59 


09700 




DEFM 


ly. 




063B 85 


09710 




DEFB 


85H 




063F 49 


09720 




DEFM 


'I' 




0640 07 


09730 




DEFB 


07H 




0641 4E 


09740 




DEFM 


'N' 




0642 06 


09750 




DEFB 


06H 




0643 56 


09760 




DEFM 


'V 




0644 9B 


09770 




DEFB 


9BH 




0645 41 


09780 


RA 


DEFM 


'A- 




0646 11 


09790 




DEFB 


IIH 




0647 42 


09800 




DEFM 


'B' 




0648 13 


09810 




DEFB 


13H 




0649 43 


09820 




DEFM 


•C 




064A 12 


09830 




DEFB 


12H 




064B 44 


09840 




DEFM 


'D' 




064C 15 


09850 




DEFB 


15H 




064D 45 


09860 




DEFM 


'E' 




064E 14 


09870 




DEFB 


14H 




064F 48 


09880 




DEFH 


'H' 




0650 17 


09890 




DEFB 


17H 




06 51 4C 


09900 




DEFH 


'L' 




0652 16 


09910 




DEFB 


16H 




0653 4D 


09920 




DEFM 


•M' 




0654 97 


09930 




DEFB 


97H 




0655 46 


09940 




DEFM 


ipi 




0656 10 


09950 




DEFB 


lOH 




0657 50 


09960 


PCP 


DEFH 


ipi 




0658 99 


09970 
09980 




DEFB 


99H 






09990 




WRITE TO CASSETTE TAPE 




10000 


; 








0659 CDPAOl 


10010 


WRIT 


CALL 


G3N 




065C D5 


10020 




PUSH 


DE 




06 5D E5 


10030 




PUSH 


HL 




065E C5 


10040 




PUSH 


BC 




065F 3E02 


10050 


GNAM3 


LD A, 


2H 




0661 D3EC 


10060 




OUT 


OECH) ,A 




0663 AF 


10070 




XOR A 


,-ZERO ACCUMULATOR 


0664 CDDD06 


10080 


LEAD 


CALL 


TOUT 




0667 lOFB 


10090 




DJNZ 


LEAD 




0669 3EA5 


10100 


WRITl 


LD A, 


0A5H 


ISYNC HARK 


066B CDDD06 


10110 




CALL 


TOUT 




066E 3E55 


10120 




LD A, 


55H 


;FILE NAME MARK 


0670 CDDD06 


10130 




CALL 


TOUT 


.-WRITE NAME HEADER 


0673 0606 


10140 




LD B, 


06H 


:6 BYTE NAME 


0675 CDE502 


10150 




CALL 


GETl 


;LAST ENTRY 


0678 380E 


10160 




JR C, 


FINE 


;IP COMMA NO NAME F 


067A CDE302 


10170 


WNAHB 


CALL 


GET 


.-NEXT ENTRY 


067D 3809 


10180 




JR C, 


FINE 


: FINISH WITH BLANKS 


067P CDDD06 


10190 




CALL 


TOUT 


; WRITE NAME 


0682 10P6 


10200 




DJNZ 


WNAME 




06 84 FD23 


10210 




INC lY 


:ADJUST BUFFER 


0686 1807 


10220 




JR WRIT3 


;PULL NAME 


0688 3E20 


10230 


FINE 


LD A, 


20H 


; FINISH WITH BLANKS 


06 8A CDDD06 


10240 




CALL 


TOUT 




068D 10F9 


10250 




DJNZ 


FINE 




068P Dl 


10260 


KRIT3 


POP DE 
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06 90 


El 


10270 


POP HL 


06 91 


15 


10280 WRIT2 


DEC D 


06 92 


FAC106 


10290 


JP H, FINISH 


0695 


AF 


10300 


XOR A 


0696 


CD9B06 


10310 


CALL TDATA 


0699 


18F6 


10320 


JR WRIT2 


06 9B 


47 


10330 TDATA 


LD B.A 


06 9C 


3E3C 


10340 


LD A.3CH 


069E 


CDDD06 


10350 


CALL TOUT 


06A1 


78 


10360 


LD A,B 


06A2 


CDDD06 


10370 


CALL TOUT 


06A5 


7D 


10380 


LD A,L 


06A6 


CDDD06 


10390 


CALL TOUT 


06A9 


7C 


10400 


LD A,H 


06AA 


CDDD06 


10410 


CALL TOUT 


06AD 


7C 


10420 


LD A.H 


06AE 


22FE3F 


10430 


LD (3FPEH) ,HL 


06 Bl 


7C 


10440 


LD A,H 


06B2 


85 


10450 


ADD A,L 


06B3 


4F 


10460 


LD C,A 


06B4 


7E 


10470 TDATAl 


LD A, (HL) 


06B5 


CDDD06 


10480 


CALL TOUT 


06B8 


7E 


10490 


LD A,(HL) 


06B9 


81 


10500 


ADD A,C 


06BA 


4F 


10510 


LD C,A 


06 BE 


23 


10520 


INC HL 


06BC 


10F6 


10530 


DJNZ TDATAl 


06BE 


79 


10540 


LD A,C 


06 BF 


181C 


10550 


JR TOUT 


06C1 


AF 


10560 FINISH 


XOR A 


06C2 


BB 


10570 


CP E 


06C3 


2804 


10580 


JR Z, WRITS 


06C5 


7B 


10590 


LD A,E 


06C6 


CD9B06 


10600 


CALL TDATA 


06G9 


3E78 


10610 WRIT5 


LD A,7 8H 


06CB 


CDDD06 


10620 


CALL TOUT 


06CE 


El 


10630 


POP HL 


06CF 


7D 


10640 


LD A,L 


06D0 


CDDD06 


10650 


CALL TOUT 


06D3 


7C 


10660 


LD A,H 


06D4 


CDDD06 


10670 


CALL TOUT 


06D7 


CD7901 


10680 


CALL PNHL 


06DA 


C31503 


10690 


JP TOFFl 


06DD 


D9 


10700 TOUT 


EXX 


06DE 


0E08 


10710 


LD C,8 


06E0 


57 


10720 


LD D,A 


06 El 


37 


10730 TOUTl 


SCF 


06E2 


CDF706 


10740 


CALL PULSE 


06ES 


7A 


10750 


LD A,D 


06 E6 


07 


10760 


RLCA 


06 E7 


57 


10770 


LD D,A 


06E8 


CDF706 


10780 


CALL PULSE 


06EB 


OD 


107 90 


DEC C 


06 EC 


20F3 


10800 


JR N2, TOUTl 


06EE 


3A8038 


10810 


LD A, (3880H) 


06F1 


B7 


10820 


OR A 


06F2 


D9 


10830 


EXX 



^% 



;SHOW SOMETHING 



: START OF CHECKSUM 
: CHECKSUM STORAGE 



;NOTHING TO WRITE EXCEPT HEAD 

;LAST BLOCK HEADER 
: EXECUTE ADDRESS 



;SHOW ADDRESS 
:TURN TAPE OFF 
;SAVE REGISTERS 



: CARRY WILL OUTPUT A PULSE 

:OUT SYNC PULSE 

;GET DATA BIT 

!PUT IN CARRY 

; RETURN TO D REGISTER 

;OUT WHATEVER 



; SHIFT PRESSED 

;SET FLAG 

; RESTORE REGISTERS 
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06F3 
06F6 
06F7 
06F9 
06FA 
06FC 
06FE 
0700 
0702 
0703 
0705 
0707 
0709 
070 A 
070C 
a70E 
0710 



0711 
0714 
0716 
0718 
071A 
0710 
071F 
0722 
0723 
07 25 
07 27 
0729 
07 2C 
07 2E 
0730 
0733 
0735 
0738 
07 3 A 
073C 
073F 
0740 
0741 
0743 
0746 
0749 
07 4B 
07 4D 
07 4F 
0751 
0754 
0755 
0758 
0759 
075C 
07 5D 
0760 



C21503 

C9 

3E00 

17 

D3FF 

0610 

lOFE 

E601 

17 

D3FP 

0610 

lOFE 

AF 

D3FF 

0674 

lOFE 

C9 



CDE302 

28FB 

3807 

PD2B 

€03202 

1803 

210000 

E5 

3E02 

D3EC 

FD2B 

CD9B07 

FEA5 

20F9 

2A4040 

0606 

CD8F07 

PE55 

2038 

CD8F07 

77 

23 

10F9 

224040 

CD8F07 

FE78 

282A 

FE3C 

2023 

CD8F07 

47 

CD8F07 

6F 

CD8Fa7 

67 

22FE3F 

85 



10840 
10850 
10860 
10870 
10880 
10890 
10900 
10910 
10920 
10930 
10940 
10950 
10960 
10970 
10980 
10990 
11000 
11010 
11020 
11030 
11040 
11050 
11060 
11070 
11080 
11090 
11100 
11110 
11120 
11130 
11140 
11150 
11160 
11170 
11180 
11190 
11200 
11210 
11220 
11230 
11240 
11250 
11260 
11270 
11280 
11290 
11300 
11310 
11320 
11330 
11340 
11350 
11360 
11370 
113 80 
11390 
11400 



EDll 
FD22 



JP NZ,T0FF1 

RET 

LD A,00H 

RLA 

OUT (OFFH) ,A 

LD B,16D 

DJNZ PI 

AND 01 H 

RLA 

OUT (OFFH) .A 

LD B,16D 

DJNZ P2 

XOR A 

OUT (OFFH) ,A 

LD B,116D 

DJNZ P3 

RET 



;IF NON-ZERO GET OUT 

: CLEAR AC WITHOUT CLEARING CARRX 
:00 OR 01 DEPENDING UPON DATA 

; SHORT DELAY 

IKEEP INFORMATION BUT NO 

: CARRY 

;IF 1 ANOTHER PULSE 

: DELAY 

; RETURN TO ZERO LEVEL 

;REMAINDER OF MILLISECOND 



READ CASSETTE TAPE 



CALL GET 

JR Z,READ 

JR C,RD11 

DEC lY 

CALL GHL 

JR RD22 

LD HLrOOH 

PUSH HL 

LD A,02H 

OUT (OECH) ,A 

DEC lY 

CALL BIT 

CP 0A5H 

JR NZ,RD1 

LD HL, (CURSOR) 

LD B,6H 

CALL BYTE 

CP 55H 

JR NZ,TOPP 

CALL BYTE 

LD (HL) ,A 

INC HL 

DJNZ RD2 

LD (CURSOR) ,HL 

CALL BYTE 

CP 78H 

JR Z,END1 

CP 03CH 

JR NZ,TOFF 

CALL BYTE 

LD B,A 

CALL BYTE 

LD L,A 

CALL BYTE 

LD H,A 

LD (3FPEH) ,HL 

ADD A,L 



;SKIP SPACES 



;WILL POP TO DE 



:TURN ON TAPE 
[ADJUST 



; SYNC? 

;GET CURSOR WANT LOAD FAST 



; ADJUST POINTER AND PROVIDE SPACE 



; START OF CHECKSUM 
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0761 


4F 


11410 




LD C,A 


0762 


Dl 


11420 




POP DE 


0763 


D5 


11430 




PUSH DE 


0764 


19 


11440 




ADD HL,DE 


0765 


CD8F07 


11450 


RD4 


CALL BYTE 


0768 


77 


11460 




LD (HL) ,A 


0769 


23 


11470 




INC HL 


076A 


81 


11480 




ADD A,C 


076B 


4F 


11490 




LD C,A 


076C 


10F7 


11500 




DJNZ RD4 


076E 


CD8F07 


11510 




CALL BYTE 


0771 


B9 


11520 




CP C 


0772 


28D2 


11530 




JB Z,RD3 


0774 


C30003 


11540 


TOPF 


JP ERROR 


0777 


CD8F07 


11550 


ENDl 


CALL BYTE 


077A 


6F 


11560 




LD L,A 


077B 


CD8F07 


11570 




CALL BYTE 


077E 


67 


11580 




LD H,A 


077F 


Dl 


11590 




POP DE 


0780 


110000 


11600 




LD DE,OOH 


07 83 


19 


11610 




ADD HL,DE 


0784 


CD7901 


11620 




CALL PNHL 


0787 


223C40 


11630 




LD (PCSAVE) ,HL 


07 8ft 


FD23 


11640 




INC lY 


07 8C 


C31503 


11650 




JP TOPFl 


07 8F 


C5 


11660 


BYTE 


PUSH BC 


0790 


E5 


11670 




PUSH HL 


07 91 


0608 


11680 




LD B,8H 


0793 


CD9B07 


11690 


BYTEl 


CALL BIT 


0796 


lOFB 


11700 




DJNZ BYTEl 


07 98 


El 


11710 




POP HL 


0799 


CI 


11720 




POP BC 


07 9A 


C9 


11730 




RET 


07 9B 


C5 


11740 


BIT 


PUSH BC 


07 9C 


F5 


11750 




PUSH AF 


07 9D 


AF 


11760 




XOR A 


079E 


D3FF 


11770 




OUT (OPFH) ,A 


07A0 


3A8038 


117 80 


BITl 


LD A, (3880H) 


07A3 


B7 


11790 




OR A 


07A4 


20CE 


11800 




JR NZ,TOFF 


07A6 


DBFF 


11810 


BITS 


IN A,(0PPH) 


07 AS 


17 


11820 




RLA 


07A9 


30F5 


11830 




JR NC.BITl 


07AB 


066E 


11840 




LD B,6EH 


07AD 


lOPE 


11850 


BIT2 


DJNZ BIT2 


07AF 


AF 


11860 




XOR A 


07B0 


D3FP 


11870 




OUT (OFFH) ,A 


07B2 


0698 


11880 




LD B,98H 


07B4 


lOPE 


11890 


BIT3 


DJNZ BIT3 


07 B6 


DBFF 


11900 




IN A, (OFPH) 


07 B8 


4F 


11910 




LD C,A 


07B9 


Fl 


11920 




POP AF 


07 BA 


CBll 


11930 




RL C 


07 BC 


17 


11940 




RLA 


07 ED 


CI 


11950 




POP BC 


07 BE 


C9 


11960 
11970 




RET 



;GET BIAS FOR LOAD 
:BIAS ADDED TO HL 



;GET CHECKSUM 



;HL HAS START ADDRESS 
; CORRECT STACK AND ZERO 



,- STORE TO PC PLACE 
[ADJUST BUFFER 
;TURN TAPE OFF 



.-RESET LATCH BEFORE READ 

;SET FLAG IF EITHER SHIFT PRESSED 



iWAIT FOR PULSE 
; SHORT DELAY 



; RESET LATCH 

[WINDOW TO LOOK FOR PULSE 



[IN DATA A 1 IS IN POSITION (7) 



[ONE BIT ROTATE THROUGH AC 
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11980 




IFIND ONE OR 






11990 




; 


07BF 


3E02 


12000 


FINDTO LD A,02H 


07C1 


1802 


12010 




JR FIND 


07C3 


3E01 


12020 


FIMDON LD A,01H 


07C5 


324340 


12030 


FIND 


LD (COUNT) ,A 


07C8 


CDPAOl 


12040 




CALL G3N 


07 CB 


7B 


12050 


FNDl 


LD A,E 


07CC 


EDAl 


12060 


FND2 


CPI 


07CE 


EO 


12070 




RET PO 


07CF 


20FB 


12080 




JR NZ,FND2 


07Da 


3A4340 


12090 




LD A, (COUNT) 


07D4 


3D 


12100 




DEC A 


07D5 


2806 


12110 




JR Z.SHOW 


07D7 


7A 


12120 




LD A,D 


07D8 


BE 


12130 




CP (HL) 


07D9 


2802 


12140 




JR Z,SHOW 


07DB 


ISEE 


12150 




JR FNDl 


07DD 


3A4340 


12160 


SHOW 


LD A, (COUNT) 


07E0 


C5 


12170 




PUSH BC 


07EX 


4F 


12180 




LD C,A 


07E2 


0600 


12190 




LD B,00H 


07E4 


2B 


12200 




DEC HL 


07E5 


CD9503 


12210 




CALL DISPl 


07E8 


CI 


12220 




POP BC 


07 E9 


ISEO 


12230 




JR FNDl 


0000 




12240 




END 


OOOOC 


TOTAL 


ERRORS 






ADDR 


0180 


02530 


05500 


05850 07700 07 


ADDR] 


0183 


02540 


07150 


08380 


addr: 


0186 


02550 


07300 




ADJUST 0175 


02440 


02390 




ALLl 


05AE 


08880 


08720 


08750 08940 


ALL 3 


0590 


08730 


08870 




ASCII 


0351 


05480 


05160 




ASClll 0354 


05490 


05570 




ASC1I2 035C 


05520 


05580 




ASCII4 035D 


05530 






BACKW 052C 


08200 


07990 




BIT 


07 9B 


11740 


11150 


11690 


BITl 


07A0 


11780 


11830 




BIT2 


07AD 


11850 


11850 




BIT3 


07B4 


11890 


11890 




BITS 


07A6 


11810 






BKSP 


01D9 


03130 


03010 




BOTM£ 


4026 


00220 


06730 




BPNO 


4045 


00160 


01730 


01920 06530 


BPOINT 4048 


00170 


01630 


06660 


BREAK 


03F1 


06390 


06340 




BREAKl 0401 


06460 


06590 


06650 


BREAKS 4080 


00250 


01810 


06280 


BUF 


0127 


01970 


00930 




BUFO 


012C 


01990 






BUFl 


01 2F 


02010 


02120 


02170 02240 


BUFFER 4080 


00090 


00250 


00910 05060 05£ 



;FLAG FOR FINDING TWO BYTES 

;FLAG FOR FINDING ONE BYTE 

;SAVE FOR REFERENCE 

:GET ARGUMENTS 

■■LOW ORDER BYTE OR ONLY BYTE 

;IS IT THERE 

jFINISHED AND NOT FOUND 

[NOT THERE BUT CONTINUE SEARCH 

:HORE THAN ONE 

;IF ONE NOW ITS ZERO 

NEED SECOND BYTE 

IT MUST BE NEXT. THE CPI INC HL 

IT WAS THERE SO SHOW IT 

CONTINUE SEARCH START WITH FIRST 

GET NUMBER, DESTROYED BY DEC 

SAVE 

PREPARE FOR DISPLAY 

: ADJUST HL 

;SHOW ADDRESS FOLLOWED BY DATA 
.-GET BYTES REMAINING 
(CONTINUE GET ALL OCCURRENCES 
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BUPFE 


0368 


05620 


05170 






BYTE 


078F 


11660 


11200 


11230 


11280 11330 11350 11370 11450 








IISIO 


11550 


11570 


BYTEl 


0793 


11690 


11700 






CAP IT 


02BC 


04570 


04550 






CD 


00 8A 


01050 


01060 


05790 




CHAR 


02CB 


04660 


04640 






CHKIN 


026D 


04050 


02850 


03960 




CLEAR 


01F2 


03270 


03110 


03310 




CLEARS 


OlED 


03250 


00790 


05180 




CLRBP 


0107 


01720 


00890 


01660 


05080 


CLRBPl 


OllD 


01870 


01900 






CMAHK 


4044 


00150 


00840 


03150 




CHND 


0080 


01010 


05000 






COM! 


006F 


00910 


06160 






COMAND 


006C 


00900 


04880 






COHTAB 


031B 


05150 


01090 






CON 


002B 


00580 


00550 






CONl 


0033 


00620 


00590 






C0N2 


004C 


00760 


00630 






CONTCP 


0571 


08610 


08640 






CONTIl 


02F6 


04970 


04990 






CONTIN 


02F8 


04980 


01020 


05110 




COUNT 


4043 


00140 


12030 


12090 


12160 


CRT 


01B2 


02940 


02160 
09170 


02220 
09360 


02650 05530 07940 08020 09070 


CURSOR 


4040 


00120 


02960 


03140 


11180 11270 


Dl 


0279 


04120 


04120 






DELETE 


013E 


02080 








DISPl 


0395 


05850 


01710 


05910 


12210 


DISP2 


0398 


05860 


05920 






DISPLY 


0392 


05840 


05190 






DLT 


0142 


02100 








DLTE 


0147 


02130 


02200 






DLTEl 


0148 


02140 








ENDl 


0777 


11550 


11300 






ENT 


0520 


08120 


08230 






ENTl 


0523 


08150 


08110 






ENTER 


03B4 


06100 


05220 


05350 




ERO 


0305 


05030 


05050 






ERl 


030C 


05060 


05040 






ER2 


0317 


05100 








ERROR 


0300 


05010 


01080 
08630 


01120 
11540 


03500 03700 05250 05260 05400 


EXAM 


0553 


08470 


05390 


08480 




EXAM2 


0566 


08560 


08530 






EXAM 3 


056A 


08580 








EXX 


OOCP 


01450 


01390 






FILL 


03A5 


05980 


05150 






FILLl 


03A9 


06000 


00780 


06030 




FINE 


0688 


10230 


10160 


10180 


10250 


FIND 


07C5 


12030 


12010 






FINDON 


07C3 


12020 


05210 






FINDTO 


07 BF 


12000 


05320 






FINISH 


06C1 


10560 


10290 






FIRST 


0530 


08230 


07970 






FLAGl 


05F6 


09300 


09380 







^ 
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FLAG2 

FLAGP 

FNDl 

FND2 

FOUND 

FOUNDl 

FTRB 

G2N 

G2M0 

G2N1 

G2N2 

G2N3 

G3N 

GBXTE 

GET 

GETl 



0600 
05EF 
07CB 
07 CC 
0606 
060C 
0631 
0203 
020C 
0222 
0229 
022D 
OlFA 
025D 
02E3 



09360 
09270 
12050 
12060 
09390 
09430 
09650 
03400 
03440 
03530 
03570 
03610 
03350 
03950 
04850 



GET3 02F3 04930 
GHL 0232 03660 



GHLO 

GHLl 

GNAH3 

GO 

GOl 

G02 

G04 

HDATA 

HEXM 

HLSAVE 

IN 

INCK 

INNEXT 

INSl 

INS2 

1NS3 

INSERT 

JHP 

KYDl 

LDHL 

LDREG 

LEAD 

LINEF 

LIST 

LOWBIT 

MINUS 

MONSP 

MOVl 

MOVE 

NADDS 

NALPHl 

NALPHA 

NBWADl 

NEW ADR 

NEWLIN 



0235 
0240 
065F 
03C7 
03D9 

03 DC 
0447 
0295 
046D 
403A 
0482 
051D 
0487 
04EA 
04ED 
04FB 
04E7 
42A0 
0283 
0197 
0424 
0664 
01C7 
04A1 
029B 
0418 
42C0 
04AP 

04 AC 
0529 
02C3 
02BF 
04E2 
04E4 
019E 



03670 
03710 
10050 
06220 
06290 
06300 
06800 
04310 
07100 
00240 
07250 
08100 
07280 
07880 
07 890 
07950 
07870 
00350 
04210 
02710 
06660 
10080 
03060 
07410 
04350 
06600 
00340 
07500 
07490 
08180 
04610 
04590 
07840 
07850 
02810 



09340 

08780 09630 

12150 12230 

12080 

08620 

09450 

09290 

03350 05480 05840 07250 

03450 

03470 

03520 03620 

03430 

05980 07490 08290 10010 12040 

02010 03990 04020 07950 

01050 03440 03670 03720 05030 05620 06300 

06390 08470 08510 09430 10170 11040 

03420 03490 04980 06140 06290 07730 07810 

10150 

03370 03400 03510 03530 06360 06450 06550 

06600 07100 07120 07610 07630 07690 07720 

07870 09470 11080 

03680 

03740 

05200 

06380 06540 

06310 

06780 

04250 04340 

05230 

01270 01330 06910 

05290 

08010 

07390 

08170 08190 08220 

08090 

05340 

06680 06700 06720 07040 07060 

04090 04130 

03710 08080 

06320 

10090 

02990 

05270 

04320 

06430 

00350 00880 01010 01670 

05280 
08040 

04700 04740 
04500 
07750 

01040 02530 08740 
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NEXT 0289 04230 04280 

NOSFT 02AD 04470 04450 

N0T7 02CE 04680 04600 

NOTTWO 0622 09560 09440 09520 

NPRIM 05DA 09160 09100 

OFLAG OSFF 09350 09310 

OLD 4047 00270 03970 

ONEB 05EA 09240 09190 

OUT 04BA 07610 05300 

0UT2 OlDA 03140 03050 

PI 06FE 10900 10900 

P2 0707 10950 10950 

P3 070E 10990 10990 

PCH 0150 02180 02070 a 

PCHAR 0152 02190 02090 if 

PCP 0657 09960 08670 ' 

PCSAVE 403C 00230 00240 00290 01250 01420 01440 01690 06370 

06570 06620 06710 11630 

PHEX 0160 02310 02500 02520 07290 07330 09220 09250 

PHEXl 0170 02410 02450 

PHEXH 0163 02320 02310 
PHEXL 0167 02360 

PLUS 040E 06550 06410 

PMSG 018D 02620 02670 05070 •»*» 

PMSGl 018A 02610 00900 

PNHL 0179 02490 02540 07200 10680 11620 

POPAF 0469 07050 06950 
PPHL 015F 02300 

PRIME 05DC 09170 09150 

PRIME 404B 00190 08570 08660 08810 08830 09080 

PRINIT 04F6 07930 08060 

PRNT 01A4 02840 02410 02560 02820 

PRNTl 01A5 02850 02890 

PRNTFG 404A 00180 03190 07420 07440 

PROM 401B 00310 05310 

PULSE 06F7 10860 10740 10780 

PVAL 05BB 08960 08680 08890 

PVALl 05BE 08990 09420 09580 

RA 0645 09780 08860 

RDl 0729 11150 11170 

HDll 071F 11100 11060 

RD2 073C 11230 11260 

RD22 0722 11110 11090 a 

RD3 0746 11280 11530 '| 

RD4 0765 11450 11500 ^•' 

READ 0711 11040 05330 11050 

REF 4000 00080 00090 00100 00110 00200 00270 00280 00300 

00310 00320 00330 00410 ' 

REFl 4040 00110 00120 00130 00140 00150 00160 00170 00180 

00190 

REF2 4024 00200 00210 00230 

RSAVE 00 A6 01230 06260 

RST OOFF 00070 06490 ^i|, 

RSTART 0066 00880 02030 02870 

RSTLOC 4012 00060 06240 06270 

51 OOOB 00440 00420 

52 0013 00470 00450 00560 
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53 OOIB 00510 00490 

54 0023 00550 00530 
SAVE 0373 05670 05650 
SAVEl OODE 01560 01540 

SCREEN 403E 00290 00810 01610 06100 

SHOW 07DD 12160 12110 12140 

SIGNON 0043 00730 02610 

SPACE 01A2 02830 02290 05510 07310 07340 07350 08370 08690 

08910 09280 09560 

SPCHL 015C 02290 05860 07790 07890 08150 08350 08390 

SPEC 02DB 04750 04360 

SSPLAG 4042 00130 01370 01410 06080 06930 

SSTACK 4024 00210 00220 00820 01310 06890 08990 

STEP 03AP 06070 05410 

SUBS 04C7 07700 07860 

SUBSl 04CA 07710 07830 
SUBS3 04D5 07760 

SUBSM 04C4 07690 05240 

TABLE 003B 00650 04750 

TDATA 0S9B 10330 10310 10600 

TDATAl 06B4 10470 10530 

TEH 4180 00100 05690 05730 

TOFF 0774 11540 11220 11320 11800 

TOFFl 0315 05090 10690 10840 11650 

TOUT 06DD 10700 10080 10110 10130 10190 10240 10350 10370 

10390 10410 10480 10550 10620 10650 10670 

TOU'Il 06E1 10730 10800 

TRAN 0381 05730 05630 

TTYP 4018 00300 00770 03210 

TWO 0273 04090 04150 

UCPLAG 4046 00280 01980 04510 

USER 401E 00320 05360 

USERSP 4300 00330 00340 00620 

VALHEX 024C 03800 03690 03730 08050 

VERF2 054F 08420 08320 

VERIFl 0537 08300 07570 08440 

VERIFY 0534 08290 05370 

VIDEO 3C0O 00260 03070 03080 03120 03250 

S-JNAME 067A 10170 10200 

WRIT 0659 10010 05380 
WRITl 0669 10100 

WRIT2 0691 10280 10320 

WRIT3 068F 10260 10220 

WRIT5 06C9 10610 10580 

XALL 057B 08650 01680 08490 

XTAB 0639 09660 08590 08700 
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APPENDIX F 



Source Listing for the 
2708 EPROIVi Programmer 
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443F 

443F 
4441 
4444 
4445 
4448 
444B 
444E 
4451 
4454 
4457 
4458 
445B 
445D 
445E 
4460 
4461 
4463 



FDE5 

CD8946 

AF 

32B547 

21B846 

CD8D01 

21D946 

CD8D01 

21BE47 

ES 

CD2701 

3620 

23 

3630 

23 

362C 

FDEl 



4465 
4467 
446A 
446C 
446F 
4471 
4474 
4476 
4479 
447B 
447D 
447F 
4481 
4483 
4486 
4489 
448C 
448F 
4491 
4494 



FD23 

FD7E00 

FE52 

CA9C44 

PE56 

CAA544 

FE50 

CAAE44 

FE53 

2812 

FE45 

2816 

FE2C 

C26544 

216547 

CD8D01 

C34444 

3E01 

32B547 

C3AE44 



00010 

00020 

00030 

00040 

00050 

00060 

00070 

00080 

00090 

00100 

00110 

00120 

00130 

00140 

00150 

00160 ; 

00170 

00180 

00190 PRIO 

00200 

00210 

00220 

00230 

00240 

00250 

00260 

00270 

00280 

00290 

00300 

00310 

00320 

00330 

00340 

00350 

00360 

00370 

00380 PR20 

00390 

00400 

00410 

00420 

00430 

00440 

00450 

00460 

00470 

00480 

00490 

00500 

00510 

00520 

00530 

00540 

00550 SPROG 

00560 

00570 



PROM - BURN A 2708 

DISK NAME P2708/ASM 

FOR MODIFIED TRS-BO SYSTEMS 



COMMANDS: 

READ: 

VERIFY! 

PROGRAM : 

SHORTP: 

EXIT: 



MEMORY ADDR., 8 BYTES, PROM ADDR. 



SUBROUTINES USED FROM MONITOR: 
BUF, G3N. PHSG 



ORG 0443FH 

PUSH lY 
CALL SR 
XOR A 

LD (SPFLAG) ,A 
LD HL.HESl 
CALL PMSG 
LD HL,HES2 
CALL PHSG 
LD HL, BUFFER 
PUSH HL 
CALL BUF 
LD (HL) ,20H 
INC HL 
LD (HL) , 
INC HL 
LD (KL) , 
POP lY 



BRANCH TO CORRECT SECTION OF PROGRAM DEPENDING 
ON COMMAND ENTERED 



,30H 



:SAVE MONITOR POINTER 

;SET UP AND REMOVE VOLTAGES 

;CLEAR SHORT PROGRAM CYCLE FLAG 

; PRINT 'PROM PROGRAMMING PROGRAM' 

; PRINT PROMPT (>1 



:GET DATA 
;PUT SPACE 



;IN CASE THIRD ARGUMENT NOT ENTERED 



INC lY 

LD A, (IY+0) 

CP 'R' 

JP Z,RCMD 

CP 'V 

JP Z.VCHD 

CP 'P' 

JP Z.PCMD 

CP 'E' 

JR Z, SPROG 

CP 'E' 

JR Z,BXIT 

CP ' .' 

JP NZ,PR20 

LD HL.MESA 

CALL PHSG 

JP PRIO 

LD A,01H 

LD (SPFLAG) , 

JP PCHD 



;IF EXIT, RETURN TO MONITOR 

!IF COMMA, PRINT 'UNKNOWN COMMAND' 
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4497 


FDEl 


00580 EXIT 


POP lY 


4499 


FD23 


00590 


INC lY 


449B 


C9 


00600 
0061C ; 
00620 : 


RET 






00630 t 


R - READ 






00640 ; 




449C 


CD0B02 


00650 RCMD 


CALL G3N 


449F 


CD7745 


00660 


CALL READ 


44A2 


C34444 


00670 
00680 : 


JP PRIO 






00690 : 


V - VERIFY 






00700 ; 




44AS 


CD0B02 


00710 VCHD 


CALL G3N 


44A8 


CD9045 


00720 


CALL VERIFY 


44AB 


C34444 


00730 
00740 T 


JP PRIO 






00750 : 


P - PROGRAM 






00760 ; 




44AE 


CD0B02 


0077 PCMD 


CALL G3N 


44B1 


ED43B847 


00780 


LD (MBYTES) ,BC 


44B5 


ED53BA47 


00790 


LD (PROMA) .DE 


44B9 


22BC47 


00800 


LD (KEMA) ,HL 


44BC 


010004 


00810 


LD BC,1024 


44BP 


210148 


00820 


LD HL.FWM 


44C2 


110000 


00830 


LD DE,OOH 


44C5 


CD7745 


00840 
00850 ! 


CALL READ 






00860 ; 


CHECK IF IT'S 






00870 : 




44C8 


210148 


00880 


LD HL.FWM 


44CB 


010004 


00890 


LD BC.1024 


44CE 


7E 


00900 PIO 


LD A, (HL) 


44CF 


FEFF 


00910 


CP OFFH 


44D1 


C2E444 


00920 


JP NZ,P20 


44D4 


23 


00930 


INC HL 


44D5 


OB 


00940 


DEC BC 


44D6 


78 


00950 


LD A.B 


44D7 


Bl 


00960 


OB C 


44D8 


C2CE44 


00970 


JP NZ,P10 


44DB 


217647 


00980 


LD HL,HESB 


44DE 


CD8DC1 


00990 


CALL PHSG 


44E1 


C34045 


01000 


JP P80 


44E4 


211247 


01010 P20 


LD HL.HESS 


44E7 


CD8D01 


C1020 
01030 : 


CALL PHSG 






01040 : 


DETERMINE WHETl 






01050 I 


IF ATTEMPT IS I 






01060 ; 


IT KOK'T WORK 






0107 ; 




44EA 


210148 


01080 


LD HL.FVffl 


44ED 


ED5BBA47 


01090 


LD DE, (PROMA) 


44F1 


19 


01100 


ADD HL,DE 


44F2 


EB 


OHIO 


EX DE.HL 


44F3 


2ABC47 


01120 


LD HL, (HEHA) 


44F6 


ED4BBS47 


01130 


LD BC , ( NBYTES ) 


44FA 


lA 


01140 P30 


LD A, (DE) 



; BUFFER POINTER ADJUSTED 



;GET DATA *ADDRESS CHANGE MODEL III* 
r SUBROUTINE READ DOES THE WORK 



;GET DATA *ADDRESS CHANGE MODEL III* 
! SUBROUTINE VERIFY DOES THE WORK 



.-♦ADDRESS CHANGE MODEL III* 
;SAVE ARGUMENTS 



!READ THE WHOLE 
:PROM INTO MEMORY 



:IT'S DIRTY 



:IT'S CLEAN 

.•PRINT 'DIRTY PROH. 



:DE = ADDRESS OF PROM DATA 
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44FB 
44PC 
44PD 
4500 
4501 
4502 
4503 
4504 
4505 
4508 
450B 
450E 
4511 
4514 
4517 
451A 
451D 
451E 
451F 
4521 
4524 
4526 
4529 
452B 
452E 
4531 
4534 
4537 
453A 
453D 



2F 

A6 

C23745 

13 

23 

OB 

78 

Bl 

C2FA44 

213547 

CD8D01 

214647 

CD8D01 

21BE47 

CD2701 

21BE47 

23 

7E 

FE59 

CA4045 

FE4E 

CA4444 

FEOD 

C21D4S 

215147 

CD8D01 

C31445 

212147 

CD8D01 

C34444 



4540 218247 



4543 
4546 
4549 
4S4D 
454E 
454F 
4552 
4556 
4558 
455B 
455C 
455E 
4561 
4564 
4568 
456C 
456F 
4572 
4575 



CD8D01 

210148 

ED5BBA47 

19 

EB 

2ABC47 

ED4BB847 

EDBO 

3ABS47 

B7 

2014 

CD0D46 

2ABC47 

ED5BBA47 

ED4BB847 

CD9045 

C34444 

CD4A46 

18EA 



01150 

01160 

01170 

01180 

01190 

01200 

01210 

01220 

01230 

01240 

01250 P50 

01260 

01270 

01280 P60 

01290 

01300 

01310 P70 

01320 

01330 

01340 

01350 

01360 

01370 

01380 

01390 

01400 

01410 

01420 PKO 

01430 

01440 

01450 : 

01460 ; 

01470 : 

01480 P80 

01490 

01500 

01510 

01520 

01530 

01540 

01550 

01560 

01570 

01580 

01590 

01600 

01610 

01620 P90 

01630 

01640 

01650 

01660 

01670 SHORT 

01680 

01690 : 

01700 : 

01710 : 



CPL 

AND (HL) 

JP NZ.PNO 

INC DE 

INC HL 

DEC BC 

LD A,B 

OR C 

JP NZ,P30 

LD HL,MES7 

CALL PHSG 

LD HL.MESS 

CALL PHSG 

LD HL, BUFFER 

CALL BUF 

LD HL, BUFFER 

INC HL 

LD A, (HL) 

CP 'Y' 

JP Z,P80 

CP 'N' 

JP Z.PRIO 

CP ODH 

JP NZ,P70 

LD HL,HES9 

CALL PMSG 

JP P60 

LD HL.MES6 

CALL PMSG 

JP PRIO 



;IF NZ IT WON'T WORK 



; PRINT 'IT COULD WORK' 
: PRINT 'CONTINUE?' 

; CHECK IF YES OR NO TYPED IN 
rIF YES, CONTINUE 

;IF NO, GO BACK TO BEGINNING 

; PRINT 'ANSWER YES OR NO' 

; PRINT 'IT WON'T WORK' 
;G0 BACK FOR NEW COMF.AND 



ATTEMPT TO PROGRAM THE 2708 



LD HL.MESC 

CALL PMSG 

LD HL.PWM 

LD DE, (PROHA) 

ADD HL,DE 

EX DE.HL 

LD HL, (MEMA) 

LD BC, (NBYTES) 

LDIR 

LD A, (SPPLAG) 

OR A 

JR NZ, SHORT 

CALL PROG 

LD HL,(MEMA) 

LD DE, (PROMA) 

LD BC, (NBYTES) 

CALL VERIFY 

JP PRIO 

CALL PCS 

JR P90 



IPRINT'WAIT FOR PROGRAMMING 
; MAX TIME 2 MINUTES' 



PROHA + FWM 



COPY MEMORY INTO BUFFER AREA 
SHORT CYCLE REQUEST 
SET FLAG 



; PROGRAM IT 



[REPEAT PROGRAM CYCLE TO VERIFY 



READ - READ PROM INTO MEMORY 
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4577 
457A 
457B 
457D 
457E 
4580 
4582 
4583 
4584 
4586 
4587 
4588 
4589 
45 8A 
458B 
458C 
458F 



CD8946 

7B 

D38D 

7A 

F670 

D38E 

C5 

CI 

DB8C 

77 

13 

23 

OB 

78 

Bl 

C27A45 

C9 



4590 E5 

4591 210000 
4594 22B647 

4597 El 

4598 CD8946 
459B 7B 

45 9C 03 80 
4S9E 7A 
459F F670 
45A1 D38E 
45A3 C5 
45A4 CI 
45A5 DB8C 
45A7 BE 
45A8 CAE945 



45AB 05 
45AC E5 
45AO 05 
45AE F5 
45AF 11E546 
45B2 7C 
45B3 CD9446 
45B6 13 
45B7 13 



01720 

01730 

01740 

01750 

01760 REAO 

01770 RDIO 

01780 

01790 

01800 

01810 

01820 

01830 

01840 

01850 

01860 

01870 

01880 

01890 

01900 

01910 

01920 

01930 

01940 

01950 

01960 

01970 

01980 

01990 

02000 VERIFY 

02010 

02020 

02030 

02040 : 

02050 

02060 VEIO 

02070 

02080 

02090 

02100 

02110 

02120 

02130 

02140 

02150 

02160 ; 

02170 ; 

02180 : 

02190 : 

02200 

02210 

02220 

02230 

02240 

02250 

02260 

02270 

02280 



BC = S BYTES TO READ 
OE = PROM ADDRESS 
HL = MEMORY ADDRESS 



;SET UP CHIP TO READ 
lOUTPUT A0-A7 

jOUTPUT A8-A10 



:GET DATA BYTES 

; STORE IT IN MEMORY 



;GET READY TO READ NEXT BYTE 



CALL SR 
LD A,E 
OUT (PB) ,A 
LD A,D 
OR 70H 
OUT (PC) ,A 
PUSH BC 
POP BC 
IN A, (PA) 
LD (HL) ,A 
INC OE 
INC HL 
DEC BC 
LD A,B 
OR C 

JP NZ.RDIO 
RET 



VERIFY - VERIFY MEMORY AGAINST PROM MEMORY 

HL = MEMORY ADDRESS 

OE = PROM MEMORY ADDRESS 

BC = S BYTES TO VERIFY 

PUSH HL 

LD HLrOOOOH :ERRS = 

LD (ERRS) ,HL 

POP HL 



CALL SR 
LD A,E 
OUT (PB) ,A 
LO A,D 
OR 70H 
OUT (PC) ,A 
PUSH BC 
POP BC 
IN A, (PA) 
CP (HL) 
JP Z.VEIOO 



;SET UP CHIP TO READ 
: OUTPUT A0-A7 

;OUTPUT A8-A10 

;IF MATCH, INCREMENT POINTERS 



THERE IS A DISCREPANCY 
WRITE 'MEMORY: XXXX XX 



PUSH BC 
PUSH HL 
PUSH DE 
PUSH AP 
LO DB,MES31 
LD A,H 
CALL 12 AH 
INC DE 
INC DE 



PROM: XXXX XX' 



; FORMAT MEMORY ADDRESS 
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45B8 


7D 


02290 


LD A,L 


45B9 


CD9446 


02300 


CALL I2AH 


45BC 


11EA46 


02310 


LD DE,MES32 


45BF 


7E 


02320 


LD A, (HL) 


45C0 


CD9446 


02330 


CALL I 2 AH 


45C3 


11FB46 


02340 


LD DE,HES34 


45C6 


Fl 


02350 


POP AF 


45C7 


CD9446 


02360 


CALL 1 2 AH 


45CA 


11F646 


02370 


LD DE,HES33 


45CD 


El 


02380 


POP HL 


4SCE 


E5 


02390 


PUSH HL 


45CF 


7C 


02400 


LD A,H 


45D0 


CD9446 


02410 


CALL 1 2 AH 


45D3 


13 


02420 


INC DE 


45D4 


13 


02430 


INC DE 


45D5 


7D 


02440 


LD A,L 


45D6 


CD9446 


02450 


CALL 1 2 AH 


45D9 


2AB647 


02460 


LD HL, (ERRS) 


45DC 


23 


02470 


INC HL 


45DD 


22B6 47 


02480 


LD (ERRS) ,HL 


45E0 


21DC46 


02490 


LD HL,MES3 


45E3 


CD8D01 


02500 


CALL PMSG 


45 E6 


Dl 


02510 


POP DE 


45 E7 


El 


02520 


POP HL 


45E8 


CI 


02530 
02540 ; 


POP EC 


45E9 


13 


02550 VEIOO 


INC DE 


45 EA 


23 


02560 


INC HL 


45EB 


OB 


02570 


DEC BC 


45EC 


3A8038 


02580 


LD A, (3880H) 


45EF 


B7 


02590 


OR A 


45F0 


CO 


02600 


RET NZ 


45P1 


78 


02610 


LD A,B 


45P2 


Bl 


02620 


OR C 


45P3 


C29B45 


02630 
02640 : 


JP NZ.VEIO 


45P6 


2AB6 47 


02650 


LD HL. (ERRS) 


45F9 


11FF46 


02660 


LD DE,MES41 


45FC 


7C 


02670 


LD A,H 


45FD 


CD9446 


02680 


CALL I2AH 


4600 


13 


02690 


INC DE 


4601 


13 


02700 


INC DE 


4602 


7D 


02710 


LD A,L 


4603 


CD9446 


02720 


CALL I 2 AH 


4606 


21FE46 


02730 


LD HL,MES4 


4609 


CDSDOl 


02740 


CALL PMSG 


460C 


C9 


02750 
02760 ; 


RET 






02770 : 


PROG - WRITE 






02780 : 








02790 : 


ALL 1024 WOR 






02800 : 


WRITTEN TO T 






02810 : 




460D 


016400 


02820 PROG 


LD BCIOOD 


4610 


3E80 


02830 PROGC 


LD A,80H 


4612 


D3 8F 


02840 


OUT (PO) ,A 


4614 


3E20 


02850 


LD A,20H 



; FORMAT MEMORY CONTENT 
; FORMAT PROM CONTENTS 

;GET PROM MEMORY ADDRESS 

; FORMAT PROM MEMORY ADDRESS 

;ERRS = ERRS + 1 

: PRINT THE DISCREPANCY 



ISHIFT FOR ESCAPE 



; FORMAT ERRS 



: PRINT 'XXXX DISCREPANCIES' 



; NUMBER OF PROGRAM LOOPS 
jMODE 0, ALL PORTS = OUTPUT 
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4616 D38E 


02860 


DOT (PC) ,A 


4618 21004C 


02870 


PGIO LD HL,LWH 


461B 11FF03 


02880 


LD DE,1023 


461E 7E 


02890 


PG20 LD A,(HL) 


461F D38C 


02900 


OUT (PA) ,A 


4621 7B 


02910 


LD A,E 


4622 D38D 


02920 


O0T (PB) ,A 


4624 7A 


02930 


LD A,D 


4625 F620 


02940 


OR 20H 


4627 D38E 


02950 


OUT (PC) ,A 


4629 F5 


02960 


PUSH AF 


462A Fl 


02970 


POP AP 


462B EE20 


02980 


XOR 20H 


462D D38E 


02990 


OUT (PC) ,A 


462F C5 


03000 
03010 


PUSH EC 




03020 


CRITICAL TI^ 




03030 




4630 0685 


03040 


LD B,133D 


4632 lOFE 


03050 PG30 DJNZ PG30 


4634 CI 


03060 


POP BC 


4635 EE20 


03070 


XOR 20H 


4637 D38E 


03080 


OUT (PC) ,A 


4639 3A8038 


03090 


LD A,(3880H) 


463C B7 


03100 


OR A 


463D CO 


03110 


RET NZ 


463E 7A 


03120 


LD A,D 


463F B3 


03130 


OR E 


4640 2B 


03140 


DEC HL 


4641 IB 


03150 


DEC DE 


4642 C21E46 


03160 


JP NZ,PG20 


4645 OD 


03170 


DEC C 


4646 C2ie46 


03180 


JP NZ,PG10 


4649 C9 


03190 
03200 


RET 




03210 


SHORT - SHO 




03220 




464a 010100 


03230 I 


GS LD BCOOOIH 


464D CD1046 


03240 I 


GSIO CALL PROGC 


4650 04 


03250 


INC B 


4651 3E44 


03260 


LD A,68D 


4653 B8 


03270 


CP B 


4654 CA6946 


03280 


JP Z,PGS20 


4657 OC 


03290 


INC C 


4658 C5 


03300 


PUSH BC 


4659 CD8946 


03310 


CALL SR 


465C 3A8038 


03320 


LD A, (3880H) 


465F B7 


03330 


OR A 


4660 CO 


03340 


RET NZ 


4661 13 


03350 


INC DE 


4662 23 


03360 


INC HL 


4663 CD6E46 


03370 


CALL CHECK 


4666 CI 


03380 


POP BC 


4667 20E4 


03390 


JR NZ.PGSIO 


4669 48 


03400 P 


GE20 LD C,B 


466A CB39 


03410 


SRL C 


466C 18A2 


03420 


JR PROGC 



;SET WHITE ENABLE 

:HL = ADDR OP LAST WORD IN BUFFER 



: OUTPUT D0-D7 
lOUTPUT A0-A7 

.-OUTPUT A8-A10 
,- SHORT DELAY 
; PULSE IT 



MODEL DEPENDENT 



;** KODEL III 152D OR 98H ** 
;WAIT 1.0 MILLISECONDS 



:END OP PULSE 

: SHIFT FOR ESCAPE 



;FINISHED A PROGRAM LOOP? 
; FINISHED WITH LOOP? 



rlNTIALIZE COUNT 

;ONE LOOP DEFINED BY C 

iKEEP TRACK OF LOOPS 

;N0 LONGER THAN LONG PROGRAM 

: AFTER 256. BAD PROM 

.•SET UP FOR 1 PASS 

;SAVE 

;SET UP TO READ 

; SHIFT FOR ESCAPE 

; CORRECT DE TO OOOOH 
: ADJUST HL ALSO 



;N0 VERIFICATION, TRY AGAIN 
: REPEAT FOR HALF NUMBER 

: PROGRAM REMAINING CYCLES 
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466E 
4671 
4672 
4674 
4675 
4677 
467 9 
467A 
467B 
467C 
467D 
467F 
46 80 
4681 
4682 
4683 
46 84 
4685 
4686 
4688 



010004 

7B 

D3 8D 

7A 

F670 

D38E 

C5 

CI 

C5 

CI 

DBBC 

BE 

CO 

13 

23 

OB 

78 

Bl 

20E9 

C9 



4689 3E90 
46 8B 03 8F 
468D 3E30 
468F D38E 

4691 C5 

4692 €1 

4693 C9 



4694 
4695 
4696 
4697 
4699 
469B 
46 9E 
46A0 
46A2 
46A3 
46A4 
46A5 
46A6 
46A7 
46A8 
46A9 
46AB 



C5 

13 

47 

E60P 

FEDA 

FAA046 

C607 

C63Q 

12 

IB 

78 

07 

07 

07 

07 

E60F 

FEOA 



03430 : 

03440 ! 

03450 ; 

03460 CHECK 

03470 CHI 

03480 

03490 

03500 

03510 

03520 

03530 

03540 

03550 

03560 

03570 

03580 

03590 

03600 

03610 

03620 

03630 

03640 

03650 

03660 ; 

03670 ; 

03680 : 

03690 SR 

03700 

03710 

03720 

03730 

03740 

03750 

03760 

03770 

03780 

03790 

03800 

03810 

03 820 

03830 I2AH 

03840 

03 850 

03 860 

03870 

03880 

03890 

03900 IHIO 

03910 

03 920 

03930 

03 940 

03 950 

03960 

03970 

03980 

03990 



CHECK - LIKE VERIFY BUT NO MESSAGES 



LD BC,0400H 
LD A,E 
OUT (PB) ,A 
LD A,D 
OR 70H 
OUT (PC) ,A 
PUSH EC 
POP BC 
PUSH BC 
POP BC 
IN A, (PA) 
CP (HL) 
RET NZ 
INC DE 
INC HL 
DEC BC 
LD A,B 
OR C 

JR NZ.CHl 
RET 



SR - SET UP CHIP TO READ 



; CHECK ALL 
;LOW ADDRESS 

:HIGH ADDRESS AND CONTROL 

;READ PROM 

; RETURN IF NO CHECK 



4. 



LD A,90H 
OUT (PC) ,A 
LD A,30H 
OUT (PC) ,A 
PUSH BC 
POP BC 
RET 



:HODE 0, PORT A = INPUT 
:PORT B + C = OUTPUT 



; SHORT DELAY 



I2AH - INTEGER TO ASCII HEX 

A = INTEGER TO CONVERT 

DE = ADDRESS OF ASCII BUFFER 

ONLY THE FLAG REGISTER IS ALTERED 



PUSH BC 
INC DE 
LD B,A 
AND OFH 
CP OAH 
JP H,IH10 
ADD A, 07 
ADD A,30H 
LD (DE) ,A 
DEC DE 
LD A,B 
RLCA 
RLCA 
RLCA 
RLCA 
AND OFH 
CP OAH 



:CONVERT LAST NIBBLE FIRST 
;SAVE THE INTEGER 



;ADD 7 FOR A-F 



;NOW CONVERT FIRST NIBBLE 



:PUT LEFT NIBBLE 
; IN RIGHT NIBBLE 
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46AD 


FAB246 


04000 




JP H, 


.1H20 


46B0 


C607 


04010 




ADD A, 7 :ADD 7 FOR A-F 


46B2 


C630 


04020 


IK20 


ADD A, 3 on 


46B4 


12 


04030 




LD (DE) ,A 


46B5 


78 


04040 




LD A, 


•B ;RESTORE REGISTERS 


46B6 


CI 


04050 




POP BC 


46B7 


C9 


04060 
04070 




RET 




46B8 


OD 


04080 


HE SI 


DEFB 


ODH 


46B9 


OD 


04090 




DEPB 


ODH 


46BA 


32 


04100 




DEPM 


'2708 EPROH PROGRAHHIMG PROGRAM 


46D8 


01 


04110 




DEFB 


01 H 


46D9 


OD 


04120 


MES2 


DEFB 


ODH 


46DA 


3E 


04130 




DEFH 


' > ' 


46DB 


01 


04140 




DEFB 


OIH 


46DC 


OD 


04150 


MES3 


DEFB 


ODH 


46DD 


4D 


04160 




DEFH 


' MEMORY : ' 


0004 




04170 


MES31 


DEPS 


4 


46E9 


20 


04180 




DEPM 


' ' 


0002 




04190 


HES3 2 


DBFS 


2 


46EC 


20 


04200 




DEFH 


' PROM : ' 


0004 




04210 


HES3 3 


DEPS 


4 


46FA 


20 


04220 




DEFH 


' ' 


0002 




04230 


HES3 4 


DEPS 


2 


46FD 


01 


04240 




DEFB 


OIH 


46FE 


OD 


04250 


HES4 


DEFB 


ODH 


0004 




04260 


MES41 


DEPS 


4 


4703 


20 


04270 




DEPM 


' DISCREPANCIES' 


4711 


01 


04280 




DEPB 


OIH 


4712 


OD 


04290 


MESS 


DEFB 


ODH 


4713 


44 


04300 




DEFH 


'DIRTY PROM. ' 


4720 


01 


04310 




DEFB 


OIH 


4721 


49 


04320 


HES6 


DEPM 


'IT WILL NOT WORK. ' 


4734 


01 


04330 




DEPB 


OIH 


4735 


49 


04340 


MES7 


DEFH 


' IT COULD WORK . ' 


4745 


01 


04350 




DEPB 


OIH 


4746 


43 


04360 


HES8 


DEFH 


'CONTINUE? ' 


4750 


01 


04370 




DEPB 


OIH 


4751 


OD 


04380 


HES9 


DEPB 


ODH 


4752 


41 


04390 




DEPM 


'ANSWER YES OR NO: ' 


4764 


01 


04400 




DEPB 


OIH 


4765 


OD 


04410 


MESA 


DEPB 


ODH 


4766 


55 


04420 




DEFH 


'UNKNOWN COMMAND' 


477 5 


01 


04430 




DEFB 


OIH 


4776 


CD 


04440 


MESB 


DEFB 


ODH- 


4777 


43 


04450 




DEPM 


'CLEAN PROH' 


4781 


01 


04460 




DEFB 


OIH 


4782 


OD 


04470 


MESC 


DEFB 


ODH 


4783 


57 


04480 




DEFH 


'WAIT FOR PROGRAMMING' 


4797 


OD 


04490 




DEFB 


ODH 


4798 


4D 


04500 




DEFH 


'MAXIMUM TIME ABOUT 2 MINUTES' 


47B4 


01 


04510 
04520 




DEFB 


OIH 


0001 




04530 


SPFLAG 


DEPS 


1 


0002 




04540 


ERRS 


DEPS 


2 


0002 




04550 


MBYTES 


DEPS 


2 


0002 




04560 


PROMA 


DEPS 


2 
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0002 
0043 
0400 
4C0O 



0127 
01 8D 
020B 

ooec 

00 8D 
008E 
008F 
0000 



04570 


HEHA 


DBFS 2 


04580 


BUFFER 


DBFS 67 


04590 


FWH 


DBFS 1024 


04600 


LWM 


EQU FWM+1023 


04610 


; 




04620 


; 


MONITOR SUBB 


04630 






04640 


BUF 


EQU 0127H 


04650 


PMSG 


EQU OIBDH 


04660 


G3N 


EQU 020BH 


04670 


PA 


EQU 8CH 


04680 


PB 


EQU SDH 


04690 


PC 


EQU 8BH 


04700 


PO 


EQU 8FH 


04710 




END 



; MODEL III NO CHANGE 
:«ODEL III NO CHANGE 
: MODEL III EQU OlFAH 



00000 TOTAL ERRORS 



BUF 0127 
BUFFER 47BB 



CHI 

CHECK 

ERRS 

EXIT 

FWH 

G3N 

1 2 AH 

IKIO 

IH20 

LWM 

MEMA 

HE SI 

HES2 

HES3 

MES31 

MBS32 

HBS33 

MES34 

HES4 

MBS41 

MBS5 

HES6 

MES7 

HESS 

HES9 

MESA 

HESB 

HESC 

NBYTES 

PO 

PIO 

P20 

P30 

P50 

P60 

P70 



4671 
466E 
47B6 
4497 
4801 
020B 
4694 

46A0 
46B2 
4C00 
47BC 
46B8 
46D9 
46DC 
46E5 
46EA 
46F6 
46FB 
46FE 
46FF 
4712 
4721 
4735 
4746 
4751 
4765 
4776 
4782 
47BS 
008F 
44CB 
44E4 
44FA 
450B 
4514 
451D 



04640 
04580 
03470 
03460 
04540 
00580 
04590 
04660 
03830 

03900 
04020 
04600 
04570 
04080 
04120 
04150 
04170 
04190 
04210 
04230 
04250 
04260 
04290 
04320 
04340 
04360 
04380 
04410 
04440 
04470 
04550 
04700 
00900 
01010 
01140 
01250 
012S0 
01310 



00270 01290 

00250 01280 01300 

03640 

03370 

02020 02460 02480 02650 

00490 

00820 00880 OlOSO 01510 04600 

00650 00710 00770 

02260 02300 02330 02360 02410 02450 02680 

02720 

03880 

04000 

02870 

00800 01120 01550 01620 

00210 

00230 

02490 

02240 

02310 

02370 

02340 

02730 

02660 

01010 

01420 

01240 

01260 

01390 

00520 

00980 

01480 

00780 01130 01560 01640 

02840 03700 

00970 

00920 

01230 

01410 
01380 
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P80 


4540 


01480 


01000 


01340 








P90 


4561 


01620 


01680 










PA 


00 8C 


04670 


01840 


02130 


02900 


03560 




PB 


00 BD 


046 80 


01780 


02070 


02920 


03480 




PC 


008E 


04690 


01810 
03720 


02100 


02860 


02950 


02990 03080 03510 


PCHD 


44AE 


00770 


00450 


00570 








PGIO 


4618 


02870 


03180 










PG20 


461E 


02890 


03160 










PG30 


4632 


03050 


03050 










PGS 


464A 


03230 


01670 










PGSIO 


464D 


03240 


03390 










PGS20 


4669 


03400 


03280 










PHSG 


018D 


04650 


00220 


00240 


00530 


00990 


01020 01250 01270 








01400 


01430 


01500 


02500 


02740 


PNO 


4537 


01420 


01170 










PRIO 


4444 


00190 


00540 


00670 


00730 


01360 


01440 01660 


PR20 
PROG 


4465 
460D 


00380 
02820 


00510 
01610 










PROGC 


4610 


02830 


03240 


03420 








PROHA 


47BA 


04560 


00790 


01090 


01520 


01630 




RCMD 


449C 


00650 


00410 










RDIO 


457A 


01770 


01910 










READ 


4577 


01760 


00660 


00840 








SHORT 


4572 


01670 


01600 










SPFLAG 


47B5 


04530 


00200 


00560 


01580 






SPROG 


448F 


00550 


00470 










■SR 


4689 


03690 


00180 


01760 


02050 


03310 




VCHD 


44A5 


00710 


00430 










VEIO 


459B 


02060 


02630 










VEIOO 


45E9 


02550 


02150 










VERIFY 


4590 


02000 


00720 


01650 
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APPENDIX G 



Source Listing for the 
2716 EPROIVI Programmer 
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4400 

4400 
4402 
4405 
4408 
440B 
44QE 
4411 
4414 
4415 
4418 
441A 
441B 
441D 
441E 
4420 



FOBS 

CDF845 

212746 

CD8D01 

214846 

CD8D01 

214547 

E5 

CD2701 

3620 

23 

3630 

23 

362C 

FDEl 



4422 
4424 
4427 
4429 
442C 
442E 
4431 
4433 
4436 
4438 
443A 
443C 
443F 
4442 
4445 
4448 
444A 
444C 



FD23 

FD7E00 

FE52 

CA4D44 

FE56 

CA56 44 

FE50 

CA5F44 

FE45 

280E 

FE2C 

C22244 

21D446 

CD8D01 

C30544 

FDEl 

FD23 

C9 



444D CD0B02 
4450 CD1E45 



00010 

00020 

00030 

00040 

00050 

00060 

00070 

00080 

00090 

00100 

00110 

00120 

00130 

00140 

00150 ; 

00160 

00170 

00180 PRIO 

00190 

00200 

00210 

00220 

00230 

00240 

00250 

00260 

00270 

00280 

00290 

00300 

00310 

00320 

00330 

00340 

00350 PR20 

00360 

00370 

00380 

00390 

00400 

00410 

00420 

00430 

00440 

00450 

00460 

00470 

00480 

00490 

00500 EXIT 

00510 

00520 

00530 

00540 

00550 

00560 RCHD 

00570 



PROM - BURN A 2716 

DISK NAME P27I6/ASM 

FOR MODIFIED TRS-80 SISTEMS 

COMMANDS: 

READ: R MEMORY ADDR. 

VERIFY: V 

PROGRAM: P 

EXIT: B 



SUBROUTINES USED FROM MONITOR: 
BUP, G3N, PHSG 



8 BYTES, PROM ADDR. 



ORG 04400H 

PUSH lY 
CALL SR 
LD HL,MES1 
CALL PHSG 
LD HL,HBS2 
CALL PMSG 
LD HL, BUFFER 
PUSH HL 
CALL BUF 
LD (HL),20H 
INC HL 
LD (HL) ,30H 
INC HL 
LD (HL),',' 
POP lY 



:SAVE MONITOR POINTER 

:SET UP AND REMOVE VOLTAGES 

: PRINT 'PROM PROGRAMMING PROGRAM' 

: PRINT PROMPT (>) 



:PUT SPACE 

:IN CASE THIRD ARGUMENT HOT ENT 

;END 



BRANCH TO CORRECT SECTION OF PROGRAM DEPENDING 
ON COMMAND ENTERED 



INC lY 

LD A,(IY+0) 

CP 'R' 

Z , RCHD 

'V 
JP Z.VCHD 
CP 'P' 
JP Z,PCMD 
CP 'E' 
JR Z.EXIT 
CP ',' 
JP NZ,PR20 
LD HL,MESA 
CALL PHSG 
JP PRIO 
POP lY 
INC lY 
RET 



JP 
CP 



R - READ 



CALL G3N 
CALL READ 



:IF EXIT, RETURN TO MONITOR 

:IF COMMA, PRINT 'UNKNOWN COMMAND' 



: ADJUST BUFFER 



:*ADDRESS CHANGE MODEL III* 

; SUBROUTINE READ DOES THE WORK 
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4453 C30544 



4456 CD0B02 
4459 CD3745 
445C C30S44 



445F CD0B02 
4462 ED433F47 
4466 ED534147 
446A 224347 



446D 
4470 
4473 
4474 
4476 
4477 
4479 
447B 
447C 
447D 
447F 
4481 
4484 
4485 
4486 
4487 
4488 
448B 
448E 
4491 
4494 
4497 



CDF845 

010008 

7B 

D3 8D 

7A 

F67a 

D38E 

C5 

CI 

DB8C 

FEFF 

C29444 

23 

OB 

78 

Bl 

C27344 

21E546 

CD8D01 

C3F944 

218146 

CD8D01 



449A ED5B4147 
449E 2A4347 
44A1 ED4B3F47 
44A5 CDFS45 
44A8 7B 
44A9 D38D 
44AB 7A 
44AC F670 
44AE D38B 



00580 

00590 

00600 

00610 

00620 VCHD 

00630 

00640 

00650 

00660 

00670 

006 80 PCHD 

00690 

00700 

00710 

00720 

00730 

00740 

00750 

00760 

00770 

00780 

00790 

00800 

00810 PIO 

00820 

00830 

00840 

00850 

00860 

00870 

00880 

00890 

00900 

00910 

00920 

00930 

00940 

00950 

00960 

00970 

00980 

00990 P20 

01000 

01010 ; 

01020 ; 

01030 ; 

01040 : 

01050 ; 

01060 

01070 

01080 

01090 

01100 P30 

OHIO 

01120 

01130 

01140 



V - VERIFY 

CALL G3N 
CALL VERIFY 
JP PRIO 

P - PROGRAM 

CALL G3N 
LD (MBYTES) ,BC 
LD (PROMA) ,DE 
LD (HEMA),HL 



;*ADDRESS CHANGE MODEL III* 

; SUBROUTINE VERIFY DOES THE WORK 



;*ADDRESS CHANGE MODEL III* 
;SAVE ARGUMENTS 



CHECK IF IT'S DIRTY 

EC = »0F BYTES TO CHECK 
HL = MEMORY TO PROGRAM 
DE = OFFSET ADDRESS 



CALL SR 
LD BC,0800H 
LD A,E 
OUT (PB) ,A 
LD A,D 
OR 07 OH 
OUT (PC) ,A 
PUSH BC 
POP BC 
IN A, (PA) 
CP OFFH 
JP NZ,P20 
INC HL 
DEC BC 
LD A,B 
OR C 

JP NZ,P10 
LD HL,HESB 
CALL PMSG 
JP P80 
LD HL,MES5 
CALL PMSG 



;SET UP TO READ 

; CHECK ENTIRE EPROH 

,-LOW ADDRESS 

;HIGH ADDRESS AND CONTROL 



; SHORT DELAY 
;GET DATA 



;IT'S DIRTY 



:1T'S CLEAN 

; PRINT 'DIRTY PROH. 



DETERMINE WHETHER IT CAN BE PROGRAMMED 
IF ATTEMPT IS MADE TO CHANGE A TO 1 , 
IT WON'T WORK 



LD DE, (PROHA) 
LD HL, (MEMA) 
LD BC,(NBYTES) 
CALL SR 
LD A,E 
OUT (PB) ,A 
LD A,D 
OR 070H 
OUT (PC) ,A 



:SET UP TO READ 
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44B0 
44B1 
44B2 
44B4 
44B5 
44B6 
44B9 
44BA 
44BB 
44BC 
44BD 
44BE 
44C1 
44C4 
44C7 
44CA 
44CD 
44D0 
44D3 
44D6 
44D7 
44D8 
44Dfl 
44DD 
44DF 
44E2 
44E4 
44E7 
44EA 
44ED 
44F0 
44F3 
44F6 



CS 

CI 

DB8C 

2F 

A6 

C2F044 

13 

23 

OB 

78 

Bl 

C2A844 

21A446 

CD8D01 

21B546 

CD8D01 

214547 

CD2701 

214547 

23 

7E 

FE59 

CAF944 

FE4E 

CA0544 

FEOD 

C2D644 

21C046 

CD8D01 

C3CD44 

219046 

CD8D01 

C30544 



44F9 210947 



44FC 
44FF 
4503 
4506 
450A 
450D 
4510 
4514 
4518 
451B 



CDBDOl 

ED4B3F47 

2A4347 

ED5B4147 

CDB645 

2A4347 

ED5B4147 

ED4B3F47 

CD37 45 

C30S44 



451E CDF845 
4521 7B 



01150 

01160 

01170 

01180 

01190 

01200 

01210 

01220 

01230 

01240 

01250 

01260 

01270 

01280 P50 

01290 

01300 

01310 P60 

01320 

01330 

01340 P70 

01350 

01360 

01370 

01380 

01390 

01400 

01410 

01420 

01430 

01440 

01450 PNO 

01460 

01470 

01480 

01490 

01500 

01510 P80 

01520 

01530 

01540 

01550 

01560 

01570 

01580 P90 

01590 

01600 

01610 

01620 

01630 

01640 

01650 

01660 

01670 

01680 

01690 

01700 READ 

01710 RDIO 



PUSH BC 

POP BC 

IN A, (PA) 

CPL 

AND (HL) 

JP NZ.PNO 

INC DE 

INC HL 

DEC BC 

LD A,B 

OR C 

JP HZ,P30 

LD HL,HES7 

CALL PMSG 

LD HL,MES8 

CALL PMSG 

LD HL, BUFFER 

CALL BUF 

LD HL, BUFFER 

INC HL 

LD A, (HL) 

CP 'Y' 

JP Z,P80 

CP 'N' 

JP Z,PR10 

CP ODH 

JP NZ,P70 

LD HL,MES9 

CALL PMSG 

JP P60 

LD HL,HES6 

CALL PHSG 

JP PRIO 



; SHORT DELAY 



;IF NZ IT WON'T WORK 



; PRINT 'IT COULD WORK' 
; PRINT 'CONTINUE?' 

; CHECK IF YES OR NO TYPED IN 
;IF YES, CONTINUE 

!IF NO, GO BACK TO BEGINNING 

; PRINT 'ANSWER YES OR NO' 

: PRINT 'IT WON'T WORK' 
:G0 BACK FOR NEW COMMAND 






ATTEMPT TO PROGRAM THE 2716 EPROM 



LD HL.MESC 

CALL PHSG 
LD BC, (NBYTES) 
LD HL.(HEHA) 
LD DE, (PROMA) 
CALL PROG 
LD HL,(HEMA) 
LD DE, (PROMA) 
LD BC, (NBYTES) 
CALL VERIFY 
JP PRIO 



READ - READ PROM INTO MEMORY 

BC = S BYTES TO READ 
DE = PROM ADDRESS 
HL = MEMORY ADDRESS 



r PRINT 'WAIT FOR PROGRAMMING 
: MAX TIME 2 MINUTES' 



lOFFSET 

: PROGRAM IT 



CALL SR 
LD A,E 



;SET UP CHIP TO READ 
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•ii^ 



4522 D3eD 

4524 7A 

4525 F670 
4527 D3aE 

4529 C5 
452A CI 
452B DB8C 
452D 77 
452E 13 
452F 23 

4530 OB 

4531 78 

4532 Bl 

4533 C22145 
4536 C9 



4537 E5 

4538 210000 
453B 223D47 
453E El 



453F 
4542 
4543 
4545 
4546 
4548 
454A 
454B 
454C 
454D 
454E 
4550 
4551 



4554 
4555 
4556 
4557 
4558 
455B 
455C 
455F 
4560 
4561 
4562 
4565 
4568 



CDF845 

7B 

D3 8D 

7A 

F670 

D38E 

C5 

CI 

C5 

CI 

DBSC 

BE 

CA9245 



C5 

E5 

D5 

F5 

115446 

7C 

CD03 46 

13 

13 

7D 

CD03 46 

115946 

7E 



01720 

01730 

01740 

01750 

01760 

01770 

01780 

01790 

01800 

01810 

01820 

01830 

01840 

01850 

01860 

01870 

01880 

01890 

01900 

01910 

01920 

01930 

01940 VERIFY 

01950 

01960 

01970 

01980 : 

01990 

02000 VEIO 

02010 

02020 

02030 

02040 

02050 

02060 

02070 

02080 

02090 

02100 

02110 

02120 : 

02130 : 

02140 ; 

02150 : 

02160 

02170 

02180 

02190 

02200 

02210 

02220 

02230 

02240 

02250 

02260 

02270 

02280 



; OUTPUT A0-A7 



; OUTPUT A8-A10 

: SHORT DELAY 

:GET DATA BYTES 

; STORE IT IN MEMORY 

;GET READY TO READ NEXT BYTE 



OUT (PB) ,A 
LD A,D 
OR 070H 
OUT (PC), A 
PUSH BC 
POP BC 
IN A, (PA) 
LD (HL) ,A 
INC DE 
INC HL 
DEC BC 
LD A.B 
OR C 

JP NZ.RDIO 
RET 



VERIFY - VERIFY MEMORY AGAINST PROM MEMORY 

HL = MEMORY ADDRESS 

DE = PROM MEMORY ADDRESS 

BC = # BYTES TO VERIFY 

PUSH HL 

LD HL,OOOOH ;ERRS = 

LD (ERRS) ,HL 

POP HL 



CALL SR 
LD A,E 
OUT (PB) ,A 
LD A,D 
OR 07 OH 
OUT (PC) ,A 
PUSH EC 
POP BC 
PUSH BC 
POP BC 
IN A. (PA) 
CP (HL) 
JP Z,VE100 



;SET UP CHIP TO READ 
; OUTPUT A0-A7 

jOUTPUT A8-A10 



;IF MATCH, INCREMENT POINTERS 



THERE IS A DISCREPANCY 
WRITE I MEMORY: XXXX XX 



PUSH BC 
PUSH HL 
PUSH DE 
PUSH AF 
LD DE,HES31 
LD A,H 
CALL 1 2 AH 
INC DE 
INC DE 
LD A,L 
CALL I 2 AH 
LD DE,HES32 
LD A, (HL) 



PROM: XXXX XX' 



: FORMAT MEMORY ADDRESS 



; FORMAT MEMORY CONTENT 
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4569 
456C 
456F 
4570 
4573 
4576 
4577 
4578 
4579 
457C 
457D 
457E 
457F 
4582 
4585 
4586 
4589 
458C 
458F 
4590 
4591 



CD0346 

116A46 

Fl 

CD0346 

116546 

El 

E5 

7C 

CD0346 

13 

13 

7D 

CD03 46 

2A3D47 

23 

223D47 

214B46 

CD8D01 

Dl 

El 

CI 



4592 13 

4593 23 

4594 OB 

4595 3A8038 

4598 B7 

4599 CO 
459R 78 
459B Bl 
459C C24245 



459F 
45A2 
45A5 
45A6 
45A9 
45AA 
45AB 
45AC 
45AF 
45B2 
45B5 



2A3D47 

116E46 

7C 

CD0346 

13 

13 

7D 

CD0346 

216D46 

CD8D01 

C9 



45B6 3E80 
45B8 D38F 
45BA 2A4347 
45BD EDSB4147 
45C1 BD4B3F47 
45C5 7E 
45C6 D38C 
45C8 7B 
45C9 D38D 



02290 

02300 

02310 

02320 

02330 

02340 

02350 

02360 

02370 

023 80 

023 90 

02400 

02410 

02420 

02430 

02440 

02450 

02460 

02470 

02480 

02490 

02500 ; 

02510 VBIOO 

02520 

02530 

02540 

02550 

02560 

02570 

02580 

02590 

02600 ; 

02610 

02620 

02630 

02640 

02650 

02660 

02670 

02680 

02690 

02700 

02710 

027 20 

02730 

02740 

02750 

02760 ,- 

02770 PROG 

02780 

02790 PGIO 

02800 

02810 

02820 PG20 

02830 

02840 

02850 



CALL I2AH 
LD DE,HES34 
POP AF 
CALL I 2 AH 
LD DE,MES33 
POP HL 
PUSH HL 
LD A,H 
CALL 1 2 AH 
INC DE 
INC DE 
LD A,L 
CALL I2flH 
LD HL,(BRRS) 
INC HL 

LD (ERRS) ,HL 
LD HL,HES3 
CALL PHSG 
POP DE 
POP HL 
POP BC 

INC DE 

INC HL 

DEC BC 

LD A, (3880H) 

OR A 

RET NZ 

LD A,B 

OR C 

JP NZ,VB10 

LD HL,(ERRS) 
LD DE,HES41 
LD A,H 
CALL I2AH 
INC DE 
INC DE 
LD A,L 
CALL I2AH 
LD HL,HES4 
CALL PMSG 
RET 



;FOR^aT PROM CONTENTS 

;GET PROM MEMORY ADDRESS 
; FORMAT PROM MEMORY ADDRESS 

;ERRS = ERRS + 1 
:PRINT THE DISCREPANCY 



; SHIFT FOR ESCAPE 
; ABORT 



; FORMAT ERRORS 



; PRINT 'XXXX DISCREPANCIES' 



PROG - WRITE MEMORY INTO PROM 



LONGEST TIME APROX. 2 MIN. 



LD A,80H 
OUT (PO),A 
LD HL, (MEMA) 
LD DE,(PROMA) 
LD BC, (NBYTES) 
LD A, (HL) 
OUT (PA) ,A 
LD A,E 
OUT (PB) ,A 



:MODE 0, ALL PORTS = OUTPUT 



!HL = ADDR OF FIRST WORD IN BUFFER 
; OFFSET 



; OUTPUT D0-D7 



tOUTPUT A0-A7 
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45CB 


7A 


02860 


LD A,D 




45CC 


F638 


02870 


OR 038H 


:TURN ON +25 AND OUT ENABLE (20) 


45CE 


D38E 


02880 


OUT (PC) ,A 


: OUTPUT A8-A10 


45D0 


C5 


02890 


PUSH BC 


;SAVE 


4SD1 


F5 


02900 


PUSH AF 


:SAVE 


45D2 


D38E 


02910 


OUT (PC) ,A 


: PROGRAMMING STARTS 


45D4 


EE80 


02920 


XOR 80H 




45D6 


D38E 


02930 
02940 ; 


OUT (PC) ,A 


! PULSE IT 






02950 : 


CRITICAL TIME 


- MODEL DEPENDENT 






02960 : 






45D8 


01800D 


02970 
02980 


LD BC,0D80H 


?*» 0F6EH MODEL III *» 
! SO MILLISECOND DELAY 


45DB 


OB 


02990 PG30 


DEC BC 


;WAIT 


45DC 


78 


03000 


LD A,B 




45DD 


Bl 


03010 


OR C 




45DE 


20FB 


03020 


JR NZ,PG30 




45E0 


Fl 


03030 


POP AF 




45E1 


CI 


03040 


POP BC 


JREGISTERS RESTORED 


45E2 


EE80 


03050 


XOR 80H 




45E4 


D38E 


03060 


OUT (PC) ,A 


;END OF PULSE 


45E6 


F670 


03070 


OR 070H 


;ALL VOLTAGES OFF 


45E8 


D38E 


03080 


OUT (PC) ,A 




45EA 


3A803 8 


03090 


LD A, (3880H) 


; SHIFT FOR ESCAPE 


45ED 


B7 


03100 


OR A 




45 EE 


CO 


03110 


RET NZ 


: ABORT 


45EF 


OB 


03120 


DEC BC 




45F0 


78 


03130 


LD A,B 




45F1 


Bl 


03140 


OR C 


:SET FLAG FOR END 


45F2 


23 


03150 


INC HL 


; ADJUST POINTERS 


45F3 


13 


03160 


INC DE 


;NEXT LOCATION 


45F4 


C2C545 


03170 


JP NZ,PG20 


:IF NOT FINSHED, DO NEXT 


45F7 


C9 


03180 
03190 ; 
03200 : 
03210 ; 


RET 








03220 : 


SR - SET UP CHIP TO READ 






03230 ; 






4SF8 


3E90 


03240 SR 


LD A,90H 




45FA 


D3 8F 


03250 
03260 


OUT (PO) ,A 


[MODE 0, PORT A = INPUT 
:PORT B AND C = OUTPUT 


45FC 


3E70 


03270 


LD A,70H 




45FE 


D38E 


03280 


OUT (PC) ,A 




4600 


C5 


03290 


PUSH BC 




4601 


CI 


03300 


POP BC 


; SHORT DELAY 


4602 


C9 


03310 
03320 ; 


RET 








03330 ; 


I2AH - INTEGER 


TO ASCII HEX 






03340 : 










03350 : 


A = INTEGER TO 


CONVERT 






03360 ; 


DE = ADDRESS OF ASCII BUFFER 






03370 : 


ONLY THE FLAG REGISTER IS ALTERED 






03380 : 






4603 


C5 


03390 I2AH 


PUSH BC 




4604 


13 


03400 


INC DE 


: CONVERT LAST NIBBLE FIRST 


4605 


47 


03410 


LD B,A 


.-SAVE THE INTEGER 


4606 


E60F 


03420 


AND OFH 
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4608 FEOA 


03430 




CP OAH 


460A FA0F46 


03440 




JP H, 


IHIO 


460D C607 


03450 




ADD A 


,07 ;ADD 7 FOR A-F 


460F C630 


03460 


IHIO 


ADD A 


,30H 


4611 12 


03470 




LD (DE) ,A 


4612 IB 


03480 




DEC DE :NOW CONVERT FIRST N] 


4613 78 


03490 




LD A, 


B 


4614 07 


03500 




RLCA 


:PUT LEFT NIBBLE 


4615 07 


03510 




RLCA 


: IN RIGHT NIBBLE 


4616 07 


03520 




RLCA 




4617 07 


03530 




RLCA 




4618 E60P 


03540 




AND OFH 


461A FEOA 


03550 




CP OAH 


461C FA2146 


03560 




JP M. 


IH20 


461F C607 


03570 




ADD A 


,,7 :ADD 7 FOR A-F 


4621 C630 


03580 


IH20 


ADD A 


,.30H 


4623 12 


03590 




LD (DE) ,A 


4624 78 


03600 




LD A, 


B ;RESTORE REGISTERS 


4625 CI 


03610 




POP BC 


4626 C9 


03620 
03630 




RET 




4627 OD 


03640 


HESl 


DEFB 


ODH 


4628 OD 


03650 




DEFB 


ODH : SPACE TO AID READ 


4629 32 


03660 




DEFH 


'2716 EPROM PROGRAMMING PROGRAM 


4647 01 


03670 




DEFB 


OIH 


4648 OD 


03680 


MES2 


DEFB 


ODH 


4649 3E 


03690 




DEFH 


'>< 


464A 01 


03700 




DEFB 


OIH 


464B OD 


03710 


MES3 


DEFB 


ODH 


464C 4D 


03720 




DEFH 


' MEMORY : ' 


0004 


03730 


HES31 


DBFS 


4 


4658 20 


03740 




DEFM 


' ' 


0002 


03750 


MEE32 


DBFS 


2 


465B 20 


03760 




DEFH 


PROM: ■ 


0004 


03770 


MES33 


DBFS 


4 


4669 20 


03780 




DEFH 


" ' 


0002 


03790 


MES3 4 


DBFS 


2 


466C 01 


03800 




DEFB 


OIH 


466D OD 


03810 


HES4 


DEFB 


ODH 


0004 


03820 


HES41 


DBFS 


4 


4672 20 


03830 




DEFH 


' DISCREPANCIES' 


4680 01 


03840 




DEFB 


OIH 


4681 OD 


03850 


HESS 


DEFB 


ODH 


4682 44 


03860 




DEFH 


'DIRTY PROM. ' 


468F 01 


03870 




DEFB 


OIH 


4690 49 


03880 


HES6 


DEFH 


'IT WILL NOT WORK. ' 


46A3 01 


03890 




DEFB 


OIH 


46A4 49 


03900 


HES7 


DEFM 


' IT COULD WORK . ' 


46B4 01 


03910 




DEFB 


OIH 


46B5 43 


03920 


MESS 


DEFM 


'CONTINUE? ' 


46BF 01 


03930 




DEFB 


OIH 


46C0 OD 


03 940 


MES9 


DEFB 


ODH 


46C1 41 


03950 




DEFH 


'ANSWER YES OR NO: ' 


46D3 01 


03960 




DEFB 


OIH 


46D4 OD 


03970 


MESA 


DEFB 


ODH 


46D5 55 


03980 




DEFH 


'UNKNOWN COMMAND' 


46E4 01 


03990 




DEFB 


OIH 
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-'4 



46E5 


OD 


04000 


MESB 


DEFB 


ODH 




46E6 


45 


04010 




DBF> 


'EPROH CLEAN IN LOCATIONS REOUE 


4708 


01 


04020 




DEFB 


OIH 




4709 


OD 


04030 


HESC 


DEFB 


ODH 




470A 


57 


04040 




DEFH 


'WAIT FOR PROGRAMMING 




471E 


OD 


04QS0 




DEFB 


ODH 




471F 


4D 


04060 




DEF!' 


'MAXIMUM TIME ABOUT 2 


MINUTES ' 


473B 


01 


04070 
04080 




DEFB 


OIH 




0001 




04090 


SPFLAG DBFS 


1 




0002 




04100 


ERRS 


DEFS 


2 




0002 




04110 


MBYTES DBFS 


2 




0002 




04120 


PROHA 


DBFS 


2 




0002 




04130 


HEHA 


DEFS 


2 




0043 




04140 


BUFFER DBFS 


67 








0.4150 


; 












04160 


: 


MONITOR SUBROUTINES 








04170 


; 








0127 




04180 


BUF 


EQU 


0127H .-MODEL III 


NO CHANGE 


01 8D 




04190 


PMSG 


EQU 


018DH ;MODEL III 


NO CHANGE 


020B 




04200 


G3N 


EQU 


020BH ;MODEL III 


EQU OlFAH 


00 8C 




04210 


PA 


EQU 


8CH 




00 8D 




04220 


PB 


EQU 


SDH 




008E 




04230 


PC 


EQU 


SEH 




0D8F 




04240 


PO 


EQU 


BFH 




0000 




04250 




END 






00000 


TOTAL 


ERRORS 










BUF 


0127 


04180 


00240 


01320 






BUFFER 47 45 


04140 


00220 


01310 


01330 




ERRS 


473D 


04100 


01960 


02420 


02440 02610 




EXIT 


4448 


00500 


00440 








G3N 


a20B 


04200 


00560 


00620 


00680 




1 2 AH 


4603 


03390 


02220 
02680 


02260 


02290 02320 02370 02410 


02640 


IHIO 


460F 


03460 


03440 








IH20 


4621 


03580 


03560 








MEMA 


4743 


04130 


00710 


01070 


0155O 015S0 02790 




HESl 


4627 


03640 


00180 








MES2 


4648 


03680 


00200 








HES3 


464B 


03710 


02450 








HES31 


4654 


03730 


02200 








MES32 


4659 


03750 


02270 








HES33 


4665 


03770 


02330 








HES34 


466A 


03790 


02300 








MES4 


466D 


03810 


02690 








MES41 


466E 


03820 


02620 








HESS 


4681 


03850 


00990 








IIES6 


4690 


03880 


01450 








HES7 


46A4 


03900 


01270 








HES8 


46B5 


03920 


01290 








HES9 

MESA 


46C0 
46D4 


03940 
03970 


01420 
00470 








MESB 
HESC 


46E5 
4709 


04000 
04030 


00960 
01510 








MBYTES 473F 


04110 


00690 


01080 


D1540 01600 02810 
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PO 

PIO 

P20 

P30 

P50 

P60 

P70 

P80 

P90 

PA 

PB 

PC 

PCMD 
PGIO 
PG20 
PG30 
PMSG 

PNO 

PRIO 

PR20 

PROG 

PROHA 

RCHD 

RDIO 

READ 

SPFLAG 

SR 

VCMD 

VEIO 

VEIOO 

VERIFY 



00 8F 
4473 
4494 
44A8 
44C4 
44CD 
44D6 
44F9 
450D 
00 8C 
008D 
008E 



04240 
00810 
00990 
01100 
01280 
01310 
01340 
01510 
01580 
04210 
04220 
04230 



445F 00680 
45BA 02790 
45C5 02820 
45DB 02990 
Oieo 04190 



44F0 
4405 
4422 
45B6 
4741 
444D 
4521 
451E 
473C 
45F8 
4456 
4542 
4592 
4537 



01450 
00180 
00350 
02770 
04120 
00560 
01710 
01700 
04090 
03240 
00620 
02000 
02510 
01940 



02780 03250 
00950 
00900 
01260 

01440 
01410 
00980 01370 

00880 01170 01780 02090 02830 

00820 OHIO 01720 02010 02850 

00850 01140 01750 02040 02880 02910 02930 

03060 03080 03280 

00420 

03170 

03020 

00190 00210 00480 00970 01000 01280 01300 

01430 01460 01530 02460 02700 

01200 

00490 00580 00640 01390 01470 01620 

00460 

01570 

00700 01060 01560 01590 02800 

00380 

01850 

00570 

00170 00790 01090 01700 01990 

00400 

02590 

02110 

00630 01610 
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APPENDIX H 



Source Listing for the 
8755 EPROM Programmer 
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00010 




PROM - BURN I 


\ 87f 


5 






00020 




DISK NAME P8755/ASM 






00030 




FOR MODIFIED 


TRS- 


-80 SYSTEMS 






00040 














00050 




COMMANDS : 










00060 




READ: R 


MEMORY ADDR., # BYTES, PROM ADDR. 






00070 




VERIFY: V 




" , " , " 






00080 




PROGRAM : P 




" , " , " 






00090 




EXIT: E 










00100 














00110 




SUBROUTINES USED 


FROM MONITOR: 






00120 




BUF, G3N, PMSG 








00130 














00140 




PORT ASSIGNMENTS 








00150 














00160 




PORT 


A 








00170 




ADDRESS 


-7 DATA 0-7 






00180 














00190 




PORT 


B 








00200 


Jbo - 


ALE Bl - 


lO/M B2 - PROG/CEl E3 - CE2 






00210 


;B4 - 


/low B5 - 


/lOR B6 - CLK E7 - /RD 






00220 














00230 




PORT 


C 








00240 


:B0 - 


A8 Bl - 


A9 


B2 - AlO B3 - XX 






00250 


;B4 - 


XX B5 - 


XX 


B6 - PROG PULSE B7 - XX 






00260 










4400 




00270 
00280 




ORG 04400H 






4400 


FDE5 


00290 




PUSH lY 




SAVE MONITOR POINTER 


4402 


CDFA45 


00300 




CALL SO 




SET UP AND REMOVE VOLTAGES 


4405 


213646 


00310 


PRIO 


LD HL.MESl 




PRINT 'PROM PROGRAMMING PROGRAM 


4408 


CD8D01 


00320 




CALL PMSG 






440B 


215746 


00330 




LD HL,MES2 




PRINT PROMPT (>l 


440E 


CD8D01 


00340 




CALL PMSG 






4411 


215447 


00350 




LD HL, BUFFER 






4414 


E5 


00360 




PUSH HL 






4415 


CD2701 


00370 




CALL BUF 




GET COMMAND BUFFER 


4418 


3620 


00380 




LD (HL),20H 




PUT SPACE 


441A 


23 


00390 




INC HL 






441B 


3630 


00400 




LD (HL) ,30H 




■IN CASE THIRD ARGUMENT NOT ENT 


441D 


23 


00410 




INC HL 






441E 


362C 


00420 




LD (HL) .' . ' 




END 


4420 


FDEl 


00430 
00440 




POP lY 










00450 




BRANCH TO CORRECT SECTION OF PROGRAM DEPENDING 






00460 




ON COMMAND ENTERED 






00470 










4422 


FD23 


00480 


PR20 


INC lY 






4424 


FD7E00 


00490 




LD A, (lY+O) 






4427 


FE52 


00500 




CP 'R' 






4429 


CA4D44 


00510 




JP Z,RCHD 






442C 


FE56 


00520 




CP 'V 






442E 


CA5644 


00530 




JP Z.VCHD 






4431 


FE50 


00540 




CP 'P' 






4433 


CA5F44 


00550 




JP Z.PCHD 






4436 


FE45 


00560 




CP 'E' 






4438 


280E 


00570 




JR Z,EXIT 




:IF EXIT, RETURN TO MONITOR 



A, 



A. 
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443A FE2C 
443C C22244 
443F 21E346 
4442 CD8D01 
4445 C30544 
4448 FDEl 
444A FD23 
444C C9 



444D CD0B02 
4450 CD2445 
4453 C30544 



4456 CD0B02 
4459 CD4045 
445C C30544 



445F CD0B02 
4462 ED434E47 
4466 ED535047 
446A 225247 



446D 
4470 
4473 
4476 
4478 
447A 
447C 
447E 
447F 
4480 
4482 
4484 
4487 
4488 
4489 
448A 
448B 
448E 
4491 
4494 
4497 
449A 



010008 

CDFA45 

CD0146 

3E90 

D38F 

3E38 

D38D 

C5 

CI 

DB8C 

FEFP 

C29744 

23 

OB 

78 

Bl 

C27044 

21F446 

CD8D01 

C3FF44 

219046 

CD8D01 



00580 

00590 

00600 

00610 

00620 

00630 EXIT 

00640 

00650 

00660 t 

00670 : 

00680 : 

00690 RCHD 

00700 

00710 

00720 

00730 

00740 

00750 VCMD 

00760 

00770 

00780 ; 

00790 ; 

00800 : 

00810 PCHD 

00820 

00830 

00840 

00850 

00860 

00870 

00880 

00890 

00900 

00910 

00920 PIO 

00930 

00940 

00950 

00960 

00970 

00980 

00990 

01000 

01010 

01020 

01030 

01040 

01050 

01060 

01070 

01080 

01090 

01100 

OHIO P20 

01120 

01130 : 

01140 : 



CP ' , ' 

JP NZ,PR20 
LD HL.MESA 
CALL PMSG 
JP PRIO 
POP lY 
INC ly 
RET 

R - READ 

CALL G3N 
CALL READ 
JP PRIO 



CALL G3N 
CALL VERIFY 
JP PRIO 



;IF COHKA, PRINT ' UNKHOWH COMMAND' 



.-ADJUST BUFFER 



;GET ARGUMENTS 

: SUBROUTINE READ DOES THE WORK 



:GET ARGUMENTS 

(SUBROUTINE VERIFY DOES THE WORK 



P - PROGRAM 

CALL G3N 

LD (NBYTES) ,BC iSAVE ARGUMENTS 

LD (PROMA) .DE 

LD (KEMA) ,HL 

CHECK IF IT'S DIRTY 

EC = «0F BYTES TO CHECK 
HL = MEMORY TO PROGRAM 
DE = OFFSET ADDRESS 



LD BC.0800H 
CALL SO 
CALL LADR 
LD A,90H 
OUT (PO) ,A 
LD A,RD 
OUT (PB) ,A 
PUSH BC 
POP BC 
IN A, (PA) 
CP OFFH 
JP NZ.P20 
INC HL 
DEC BC 
LD A,E 
OR C 

JP NZ.PIO 
LD HL.MESB 
CALL PMSG 
JP P80 
LD HL.HESS 
CALL PMSG 



CHECK ENTIRE EPROH 
SET UP AS OUTPUT 
LATCH ADDRESS IN 8755 
CHANGE A TO INPUT PORT 
SEND TO CONTROL 
SET RD LOW 



; SHORT DELAY 
;GET DATA 



;IT'S DIRTY 



iIT'S CLEAN 



; PRINT 'DIRTY PROM. 



DETERMINE WHETHER IT CAN BE PROGRAMMED 
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449D 
44A1 
44A4 
44A8 
44AB 
44AE 
44B0 
44B2 
44B4 
44B6 
44B7 
44B8 
44BA 
44BB 
44BC 
44BF 
44C0 
44C1 
44C2 
44C3 
44C4 
44C7 
44CA 
44CD 
44D0 
44D3 
44D6 
44D9 
44DC 
44DD 
44DE 
44E0 
44E3 
44E5 
44E8 
44EA 
44ED 
44F0 
44F3 
44F6 
44F9 
44FC 



ED5B5047 

2A5247 

ED4B4E47 

CDFA45 

CD0146 

3E90 

D38F 

3E38 

D38D 

C5 

CI 

DB8C 

2F 

A6 

C2F644 

13 

23 

OB 

78 

Bl 

C2A844 

21B346 

CD8D01 

21C446 

CD8D01 

215447 

CD2701 

215447 

23 

7E 

PB59 

CAFF44 

FE4E 

CA0544 

FEOD 

C2DC44 

21CP46 

CD8D01 

C3D344 

219P46 

CD8D01 

C30544 



44FF 211847 



4502 
4505 
4509 
450C 
4510 
4513 
4516 



CD8D01 

ED4B4E47 

2A5247 

ED5B5047 

CDC045 

2A5247 

ED5B5047 



01150 ; 

01160 ; 

01170 ; 

01180 

01190 

01200 

01210 P30 

01220 

01230 

01240 

01250 

01260 

01270 

01280 

01290 

01300 

01310 

01320 

01330 

01340 

01350 

01360 

01370 

01380 

01390 

01400 P50 

01410 

01420 

01430 P60 

01440 

01450 

01460 P7D 

01470 

01480 

01490 

01500 

01510 

01520 

01530 

01540 

01550 

01560 

01570 PKO 

01580 

01590 

01600 

01610 

01620 

01630 P80 

01640 

01650 

01660 

01670 

01680 

01690 

01700 P90 

01710 



IF ATTEMPT IS HADE TO CHANGE A TO 1 , 
IT WON'T WORK 



LD DE, (PROHA) 

LD HL,(HEMA) 

LD EC, (MBYTES) 

CALL SO 

CALL LADR 

LD A,90H 

OUT (PO),A 

LD A,RD 

OUT (PB) ,A 

PUSH EC 

POP BC 

IN A, (PA) 

CPL 

AND (HL) 

JP NZ.PNO 

INC DE 

INC HL 

DEC BC 

LD A,B 

OR C 

JP NZ,P30 

LD HL,HES7 

CALL PMSG 

LD HL,HES8 

CALL PMSG 

LD HL, BUFFER 

CALL BUF 

LD HL, BUFFER 

INC HL 

LD A,(HL) 

CP 'Y' 

JP Z,P80 

CP 'N' 

JP Z,PR10 

CP ODH 

JP NZ,P70 

LD HL,HES9 

CALL PMSG 

JP P60 

LD HL,HES6 

CALL PMSG 

JP PRIO 



SET UP AS ALL OUTPUT 
CHANGE TO INPUT PORT 
SET TO READ 

: SHORT DELAY 

;IF NZ IT WON'T WORK 



[PRINT 'IT COULD WORK' 
; PRINT 'CONTINUE?' 

; CHECK IF YES OR NO TYPED IN 
;IF YES, CONTINUE 

;IF NO, GO BACK TO BEGINNING 

:PRINT 'ANSWER YES OR NO' 

: PRINT 'IT WON'T WORK' 
:G0 BACK FOR NEW COMMAND 



^•1, 



ATTEMPT TO PROGRAM THE 8755 EPROH 



LD HL.MESC 

CALL PMSG 
LD BC, (NBYTES) 
LD HL, (ME^») 
LD DE, (PROHA) 
CALL PROG 
LD HL, (MEMA) 
LD DE, (PROMA) 



;PRINT'WAIT FOR PROGRAMMING 
: MAX TIME 2 MINUTES' 



(■OFFSET 

; PROGRAM IT 



Ji, 
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451A ED4B4E47 
451E CD4045 
4521 C30544 



4524 
4527 
452A 
452C 
452E 
4530 
4532 
4533 
4534 
4536 
4537 
4538 
453S 
453A 
453B 
453C 
453F 



CDPA45 

CD0146 

3E90 

D38F 

3E38 

D38D 

C5 

CI 

DB8C 

77 

13 

23 

OB 

78 

Bl 

C22445 

C9 



4540 E5 

4541 210000 
4544 224C47 
4547 El 



4548 
454B 
454E 
4550 
4552 
4554 
4556 
4557 
4558 
455A 
455B 



CDFA45 

CD0146 

3E90 

D38F 

3E38 

D38D 

C5 

CI 

DB8C 

BE 

CAA145 



455E C5 
455F E5 
4560 D5 



01720 

01730 

01740 

01750 

01760 

01770 

017 80 

01790 

01800 

01 810 

01820 READ 

01830 

01840 

01850 

01860 

01870 

01880 

01890 

01900 

01910 

01920 

01930 

01940 

01950 

01960 

01970 

01980 

01990 

02000 

02010 

02020 

02030 

02040 

02050 

02060 VERIFY 

02070 

02080 

02090 

02100 ,- 

02110 VBIO 

02120 

02130 

02140 

02150 

02160 

02170 

02180 

02190 

02200 

02210 

02220 

02230 

02240 

02250 

02260 

02270 

02280 



LD BC, (NBYTES) 
CALL VERIFY 
JP FRIO 

READ - READ PROM INTO MEMORY 

BC = S BYTES TO READ 
DE = PROM ADDRESS 
HL = MEMORY ADDRESS 



CALL SO 
CALL LADR 
LD A,90H 
OUT (PO) ,A 
LD A,RD 
OUT (PB) ,A 
PUSH BC 
POP BC 
IN A, (PA) 
LD (HL) ,A 
INC DE 
INC HL 
DEC BC 
LD A,B 
OR C 

JP NZ,REAO 
RET 



VERIFY - VERIFY MEMORY AGAINST PROM MEMORY 



;SBT UP CHIP AS OUTPUT 
:DATA IN 
,-READ 8755 



; SHORT DELAY 

;GET DATA BYTES 

; STORE IT IN MEMORY 

.-GET READY TO READ NEXT BYTE 



HL = MEMORY ADDRESS 

DE = PROM MEMORY ADDRESS 

BC - # BYTES TO VERIFY 

PUSH HL 

LD HL,OOOOH ;ERRS = 

LD (ERRS) ,HL 

POP HL 



CALL SO 
CALL LADR 
LD A,90H 
OUT (PO),A 
LD A,RD 
OUT (PB),A 
PUSH BC 
POP BC 
IN A, (PA) 
CP (HL) 
JP Z,VE100 



;SET UP CHIP TO ALL OUTPUT 



;DATA IN 

:SET UP TO READ 



;IF MATCH, INCREMENT POINTERS 



THERE IS A DISCREPANCY 
WRITE 'MEMORY: XXXX XX 

PUSH BC 
PUSH HL 
PUSH DE 



PROM: XXXX XX' 
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4561 
4562 
4565 
4566 
4569 
456A 
4S6B 
456C 
456F 
4572 
4573 
4576 
4579 
457A 
457D 
4580 
4581 
4582 
4583 
4586 
4587 
4588 
4589 
458C 
458F 
4590 
4593 
4596 
4599 
4S9C 
459D 
459E 
459F 
45A0 



F5 

116346 

7C 

CD1246 

13 

13 

7D 

CD1246 

116846 

7E 

CD1246 

117946 

Fl 

CD1246 

117446 

El 

E5 

7C 

CD1246 

13 

13 

7D 

CD1246 

2A4C47 

23 

224C47 

215A46 

CD8D01 

3A803 8 

B7 

CO 

Dl 

El 

CI 



45A1 13 
45A2 23 
45A3 OB 
45A4 78 
45A5 Bl 
45A6 C248 



4SA9 
4SAC 
45AF 
45B0 
45B3 
45E4 
45B5 
45B6 
45B9 
45BC 
45BF 



2A4C47 

117D46 

7C 

CD1246 

13 

13 

7D 

CD1246 

217C46 

CD8D01 

C9 



02290 

02300 

02310 

02320 

02330 

02340 

02350 

02360 

02370 

02380 

02390 

02400 

02410 

02420 

02430 

02440 

02450 

02460 

02470 

02480 

02490 

02500 

02510 

02520 

02530 

02540 

02550 

02560 

02570 

02580 

02590 

02600 

02610 

02620 

02630 : 

02640 VEIOO 

02650 

02660 

02670 

02680 

02690 

02700 ; 

02710 

02720 

02730 

02740 

02750 

02760 

02770 

02780 

02790 

02800 

02810 

02820 

02830 

02840 

02850 



PUSH AF 
LD DE,MES31 
LD A,H 
CALL I2AH 
INC DE 
INC DE 
LD A,L 
CALL I 2 AH 
LD DE,MES32 
LD A, (HL) 
CALL I 2 AH 
LD DE,MES34 
POP AF 
CALL I2AH 
LD DE,MES33 
POP HL 
PUSH HL 
LD A,H 
CALL 12AH 
INC DE 
INC DE 
LD A,L 
CALL 1 2 AH 
LD HL, (ERRS) 
INC HL 

LD (ERRS) ,HL 
LD HL,HES3 
CALL PMSG 
LD A, (38B0H) 
OR A 
RET NZ 
POP DE 
POP HL 
POP BC 

INC DE 
INC HL 
DEC BC 
LD A,B 
OR C 
JP NZ.VEIO 

LD HL, (ERRS) 
LD DE,MES41 
LD A,H 
CALL I 2 AH 
INC DE 
INC DE 
LD A,L 
CALL I 2 AH 
LD HL,HES4 
CALL PMSG 
RET 



; FORMAT MEMORY ADDRESS 

I FORMAT MEMORY CONTENT 
! FORMAT PROM CONTENTS 

;GET PROM MEMORY ADDRESS 

; FORMAT PROM MEMORY ADDRESS 

;ERRS = ERRS + 1 



; PRINT THE DISCREPANCY 
iCHECK FOE SHIFT 



^% 



[FORMAT ERRS 



IPRINT 'XXXX DISCREPANCIES' 



PROG - WRITE MEMORY INTO PROM 
LONGEST THE APROX. 2 HIN. 
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02860 








45C0 


2A5247 


02870 PROG 


LD HL, (MEMA) 


:HL = ADDR OF FIRST WORD IN BUFFER 


45C3 


ED5B5047 


02880 




LD DE, (PROMA) 


:OFFSET 


45C7 


ED4B4E47 


02890 




LD BC, (NBYTES) 




45CB 


3AS038 


02900 PG20 


LD A, (3B80H) 


; CHECK FOR SHIFT 


45CE 


B7 


02910 




OR A 




45CF 


CO 


02920 




RET NZ 


: ABORT 


45D0 


CDFA45 


02930 




CALL SO 


.-ALL OUTPUT 


4SD3 


CD0146 


02940 




CALL LADR 




45D6 


7E 


02950 




LD A, (HL) 


;GET DATA 


45D7 


D38C 


02960 




OUT (PA) .A 


: OUTPUT DATA 


45D9 


3 EEC 


02970 




LD A,PGWD 


;TURN ON CE2,PR0G, S +25 OFF 


45DB 


D38D 


02980 




OUT (PB) ,A 




45DD 


3ECF 


02990 




LD A.OCFH 


:ONLY WANT BITS 6 & 7 LOW FOR PULSE 


45DF 


C5 


03000 




PUSH BC 


;SAVE 


45E0 


P5 


03010 




PUSH AP 


iSAVE 


45E1 


D38E 


03020 
03030 




OUT (PC) ,A 


; PROGRAMMING STARTS 






03040 




CRITICAL TIME - 


MODEL DEPENDENT 






03050 








45E3 


OieOOD 


03060 
03070 




LD BC.ODBOH 


;** 0P6EH MODEL III ** 
: 50 MILLISECOND DELAY 


45E6 


OB 


03080 PG30 


DEC BC 


;WAIT 


45E7 


78 


03090 




LD A,B 




45E8 


Bl 


03100 




OR C 




45E9 


20FB 


03110 




JR HZ,PG30 




45EB 


Fl 


03120 




POP AP 




45EC 


CI 


03130 




POP BC 


; REGISTERS RESTORED 


45ED 


EE40 


03140 




XOR 40H 


; PULSE OFF 


45EP 


D38E 


03150 




OUT (PC) .A 


;END OF PULSE, VOLTAGES OFF 


45P1 


OB 


03160 




DEC BC 




45F2 


78 


03170 




LD A,B 




45F3 


El 


03180 




OR C 


:SET FLAG FOR END 


45F4 


23 


03190 




INC HL 


; ADJUST POINTERS 


45F5 


13 


03200 




INC DE 


:KEXT LOCATION 


45F6 


C2CB45 


03210 




JP N2,PG20 


;IP NOT FINSHED, DO NEXT 


45F9 


C9 


03220 
03230 
03240 
03250 




RET 








03260 




SO - SET UP CHIP 


TO OUTPUT 






03270 








45FA 


3E80 


03280 . 


30 


LD A,80H 




45FC 


D38F 


03290 




OUT (PO) ,A 


:MODE 0, ALL OUTPUT 


45FE 


C5 


03300 




PUSH BC 




45FF 


CI 


03310 




POP BC 


: SHORT DELAY 


4600 


C9 


03320 
03330 




RET 








03340 




LATCH ADDRESS OM 


8755 






03350 








4601 


7B 


03360 


jADR 


LD A,E 


;E HAS OFFSET LOW ADDRSS 


4602 


D3 8C 


03370 




OUT (PA) ,A 


:T0 DATA ADDRESS LINES 


4604 


7A 


033 80 




LD A,D 


:HIGH ADDRESS 


4605 


F678 


03390 




OR 7eH 


: PROGRAM VOLTAGE OFF 


4607 


D38E 


03400 




OUT (PC) .A 


; ADDRESS AND VOLTAGES SET 


4609 


3EB9 


03410 




LD A.ADDSET 


; ADDRESS SET UP 


460B 


D38D 


03420 




OUT (PB) ,A 
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460D 3EB8 


03430 




LD A, 


ALEON 




460F D38D 


03440 




OUT (PB) ,A 


; ADDRESS LATCHED 


4611 C9 


03450 
03460 




RET 








03470 




12 AH 


- INTEGER 


TO ASCII HEX 




03480 












03490 




A = INTEGER TO 


CONVERT 




03500 




DE = 


ADDRESS OE 


ASCII BUFFER 




03510 




ONLY 


THE FLAG REGISTEE IS ALTERED 




03520 










4612 C5 


03530 


[2 AH 


PUSH 


BC 




4613 13 


03540 




INC DE 


; CONVERT LAST NIBBLE 


4614 47 


03550 




LD B, 


A 


iSAVE THE INTEGER 


4615 E60F 


03560 




AND OFH 




4617 FEOA 


03570 




CP OAH 




4619 FA1E46 


03580 




JP M, 


IHIO 




461C C607 


03590 




ADD A, 07 


:ADD 7 FOR A-P 


461E C630 


03600 


IKIO 


ADD A,30H 




4620 12 


03610 




LD (DE) ,A 




4621 IB 


03620 




DEC DE 


;NOW CONVERT FIRST N 


4622 78 


03630 




LD A 


B 




4623 07 


03640 




RLCA 




:PUT LEFT NIBBLE 


4624 07 


03650 




RLCA 




; IN RIGHT NIBBLE 


4625 07 


03660 




RLCA 






4626 07 


03670 




RLCA 






4627 E60F 


03680 




AND OFH 




4629 FEOA 


03690 




CP OAH 




462B FA3046 


03700 




JP H 


IH20 




462E C607 


03710 




ADD A, 7 


:ADD 7 FOR A-F 


4630 C630 


03720 


IE20 


ADD A,30H 




4632 12 


03730 




LD (DE) ,A 




4633 78 


03740 




LD A 


B 


; RESTORE REGISTERS 


4634 CI 


03750 




POP BC 




4635 C9 


03760 
03770 




RET 






4636 OD 


03780 


■lESl 


DEFB 


ODH 




4637 OD 


03790 




DEFB 


ODH 




4638 38 


03800 




DEEM 


'8875 EPROH PROGRAHMING PROGRAM 


4656 01 


03810 




DEPB 


OIH 




4657 OD 


03820 


HES2 


DEFB 


ODH 




4658 3E 


03830 




DEFM 


•> ' 




4659 01 


03840 




DEFB 


OIH 




465A OD 


03850 


11ES3 


DEFB 


ODH 




465B 4D 


03860 




DEFH 


' KEHORY : 




0004 


03870 


MES31 


DBFS 


4 




4667 20 


03880 




DEFH 


' ' 




0002 


03890 


HES32 


DEFS 


2 




466A 20 


03900 




DEFH 


PROM 




0004 


03910 


•1ES33 


DEFS 


4 




467 8 20 


03920 




DEFH 


' ' 




0002 


03930 


HES34 


DEFS 


2 




467B 01 


03940 




DEFB 


OIH 




467C OD 


03950 


HES4 


DEFB 


ODH 




0004 


03960 


MES41 


DBFS 


4 




46 81 20 


03970 




DEFH 


' DISCREPANCIES' 


468F 01 


03980 




DEFB 


OIH 




4690 OD 


03990 


HES5 


DEFB 


ODH 





214 



4691 


44 


04000 




DEFM 


'DIRTY PROM. ' 


469E 


01 


04010 




DEFB 


OIH 


46 9F 


49 


04020 


MES6 


DEFM 


'IT WILL NOT WORK. ' 


46B2 


01 


04030 




DEFB 


OIH 


46B3 


49 


04040 


MES7 


DEFM 


'IT COULD WORK. ' 


46C3 


01 


04050 




DEFB 


OIH 


46C4 


43 


04060 


MES8 


DEFM 


'CONTINUE? ' 


46CE 


01 


04070 




DEFB 


OIH 


46CF 


OD 


04080 


HES9 


DEFB 


ODH 


46D0 


41 


04090 




DEFM 


'ANSWER YES OR NO: ' 


46E2 


01 


04100 




DEFB 


OIH 


46E3 


OD 


04110 


MESA 


DEFB 


ODH 


46E4 


55 


04120 




DEFM 


'UNKNOWN COMMAND' 


46F3 


01 


04130 




DEFB 


OIH 


46F4 


OD 


04140 


HESB 


DEFB 


ODH 


46FS 


45 


04150 




DEFM 


'EPROM CLEAN IN LOCATIONS REQUESTED' 


4717 


01 


04160 




DEFB 


OIH 


4718 


OD 


04170 


MESC 


DEFB 


ODH 


4719 


57 


04180 




DEFM 


'WAIT FOR PROGRAMMING' 


472D 


OD 


04190 




DEFB 


ODH 


472E 


4D 


04200 




DEFM 


'MAXIMUM TIME ABOUT 2 MINUTES' 


474A 


01 


04210 
04220 




DEFB 


OIH 


0001 




04230 


SPFLAG 


DEFS 


1 


0002 




04240 


ERRS 


DEFS 


2 


0002 




04250 


HBYTES 


DEFS 


2 


0002 




04260 


PROHA 


DEFS 


2 


0002 




04270 


MEMA 


DEFS 


2 


0043 




04280 
04290 


BUFFER 


DEFS 


67 






04300 




PROGRAMMING CONSTANTS 






04310 








00B8 




04320 


ALEON 


EQU 0B8H ; LATCHES ADDRESS LINES 


00B9 




04330 


ADDSET 


EQU 0B9H .-SET UP ADDRESS DATA FOR LATCH 


0038 




04340 


RD 


EQU 038H .-READ EPROM 


ODBC 




04350 


PGWD 


EQU OBCH ;CE2 HIGH 






04360 












04370 




MONITOR SUBROUTINES 






04380 








0127 




04390 


BUF 


EQU 0127H :MODEL 111 HO CHANGE 


01 8D 




04400 


PHSG 


EQU 018DH [MODEL III NO CHANGE 


020B 




04410 


G3N 


EQU 020BH iMODEL 111 EQU OlFAH 


00 8C 




04420 


PA 


EQU 8CH 


00 8D 




04430 


PB 


EQU SDH 


00 8E 




04440 


PC 


EQU 


3EH 


00 8F 




04450 


PO 


EQU 


3FH 


0000 




04460 




END 




OOOOC 


TOTAL 


ERRORS 








ADDSET 00B9 


04330 


03410 






ALEON 00B8 


04320 


03430 






EUF 


0127 


04390 


00370 01440 





BUFFER 4754 04280 
ERRS 474C 04240 
EXIT 4448 00630 
G3N 020B 04410 



00350 01430 01450 

02080 02520 02540 02710 

00570 

00690 00750 00810 
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I2AH 


4612 


03530 


02320 
02780 


02360 


02390 


02420 


02470 


02510 02740 


IHIO 


461E 


03600 


03580 












IH20 


4630 


03720 


03700 












LADR 


4601 


03360 


00930 


01220 


01830- 


02120 


02940 




HEMA 


4752 


04270 


00840 


01190 


01670 


01700 


02670 




MESl 


4636 


037 80 


00310 












MES2 


4657 


03820 


00330 












MES3 


465A 


03850 


02550 












HES31 


4663 


03870 


02300 












HES32 


4668 


03890 


02370 












HES33 


4674 


03910 


02430 












HES3 4 


4679 


03930 


02400 












MES4 


467C 


03950 


02790 












HES41 


467D 


03960 


02720 












MESS 


4690 


03990 


OHIO 












HES6 


46 9F 


04020 


01570 












HES7 


46B3 


04040 


01390 












MESS 


46C4 


04060 


01410 












HES9 


46CF 


04080 


01540 












MESA 


46E3 


04110 


00600 












HESB 


46F4 


04140 


01080 












MESC 


4718 


04170 


01630 












HBYTES 


474E 


04250 


00820 


01200 


01660 


01720 


02890 




PO 


008F 


04450 


00950 


01240 


01850 


02140 


03290 




PIO 


4470 


00920 


01070 












P20 


4497 


OHIO 


01020 












P30 


44A8 


01210 


01380 












P50 


44CA 


01400 














P60 


44D3 


01430 


01560 












P70 


44DC 


01460 


01530 












P80 


44FF 


01630 


01100 


01490 










P90 


4513 


01700 














PA 


00 8C 


04420 


01000 


01290 


01900 


02190 


02960 


03370 


PB 


00 8D 


04430 


00970 


01260 


01870 


02160 


02980 


03420 03440 


PC 


008E 


04440 


03020 


03150 


03400 








PCt4D 


445F 


00810 


00550 












PG20 


45CB 


02900 


03210 












PG30 


45E6 


03080 


03110 












PGWD 


OOBC 


04350 


02970 












PMSG 


018D 


04400 


00320 


00340 


00610 


01090 


01120 


01400 01420 








01550 


01580 


01650 


02560 


02800 




PNO 


44F6 


01570 


01320 












PRIO 


4405 


00310 


00620 


00710 


00770 


01510 


01590 


01740 


PR20 


4422 


00480 


00590 












PROG 


45C0 


02870 


01690 












PROMA 


47 50 


04260 


00830 


01180 


01680 


01710 


02880 




RCMD 


444D 


00690 


00510 












RD 


0038 


04340 


00960 


01250 


01860 


02150 






READ 


4524 


01820 


00700 


01970 










SO 


45FA 


03280 


00300 


00920 


01210 


01820 


02110 


02930 


SPFLAG 


474B 


04230 














VCHD 


4456 


00750 


00530 












VEIO 


4548 


02110 


02690 












VEIOO 


45A1 


02640 


02210 












VERIFY 


4540 


02060 


00760 


01730 
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Index 



@ command, 69-70 
A command, 68 
Address, 18 
ASCII, 24 

display, command, 68 
Assembler, 12 
Assembly language, 12-13 
Assignments, port, 23, 31-33 
Asynchronous communication, 

B 

B command, 80-81 

BASIC, 11 

Baud, 89 
rate, 94 

Bias, 62 

Blocks, data, 28-29 

Bounce, contact, 25 

Breakpoints, 60-63 

BS command, 80-81 

Buffer, 77-80 

execute, command, 80-81 
save command, 80-81 



C command, 66-67 
Cassette recorders, 96 
Checksum, 28-29, 30 
Clear command, 66-67 
Code, serial interface driver, 

for RS-232C, 91-92 
Command ( s ) 
@, 69-70 



Command ( s ) — cont 

A, 68 

B, 80-81 
BS, 80-81 
buffer save, 80-81 

C, 66-67 
clear, 66-67 

D, 59 
display, 59 

ASCII, 68 

E, 66 

examine registers, 63-65 
execute, 66 

buffer, 80-81 
execution, 54-57 
exit programmer, 115 

F, 68-69 
fill, 69-70 
find, 68-69 
format, 53-54 

G, 59-63 
go, 59-63 
H,70 

hexadecimal arithmetic, 70 

1,58 

input, 70-71 

insert, 58 

L, 75 

list, 75 

of, 55 
M,72 
move, 72 
N, 70-71 
O, 71-72 
output, 71-72 
P, 75-76, 114-115 
programming, 114-115 
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Command( s ) — cont 

Q, 69 

quest, 69 

R, 73-74 

read, 73-74, 113-114 

S, 57-58 

short-cycle program, 115 

single-step, 81-84 

substitute, 57-58 

T, 67-68 

transfer, 67-68 

U, 76-77 

user, 76-77 

V, 72-73 

verification, 114 

W, 73 

write, 73 

X, 63-65 

(modify), 65-66 

Z, 81-84 
Connectors, edge-card, 18, 30-31 
Contact bounce, 25 
Control 

signals, 22-23 

systems, 20 
"Crash," 59-60 
Current loop, 88-89 



D command, 59 
Data, 18 

blocks, 28-29 

format, tape, 27-30 

rate, 90 
Development system, 17 
DIP shunts, 15, 40-41, 42-43, 43-47 
Display 

ASCII command, 68 

command, 59 
Driver code, serial interface, 
for RS-232C, 91-92 



8755, 100 
EPROM 

i/o chip, 105-106 
programming, 117-119 
EPROM(s) 

8755, programming, 117-119 
i/o chip, 8755, 105-106 
physics, 98-99 
programmable, 99-100 
programmer 

hardware, 106-111 
using, 113 
single-voltage, 105 
2708 

program locations for, 115-116 
programming, 111-116 
2716, 99 

programming, 116-117 
2732, 100 
2758, 100 
2780, 99 
Erasable programmable 
read-only memory, 97, 98 
ROMs, 98-100 
Examine registers command, 63-65 
Execute 

buffer command, 80-81 
command, 66 
Execution, command, 54-57 
Exit programmer command, 115 



F command, 68-69 
Fill conmiand, 69-70 
Find command, 68-69 
Format 

command, 53-54 

data, tape, 27-30 

FROLIC monitor, 53 



j% 



E command, 66 
Edge-card connector, 30-31 
Editor/assembler, 13 
8255, 106 



G command, 59-63 
Go command, 59-63 



H command, 70 
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Halt modifications, 39-40 
Hardware, EPROM programmer, 

106-111 
Hexadecimal arithmetic command, 70 

1 

I command, 58 
Input 

command, 70-71 

keyboard, 25-26, 34 

/output, tape, 26-27, 35 

serial, 92-94 
Insert command, 58 
Interface 

programmable peripheral, 106 

■RS-232C, alternate, 91 

serial 

driver code for RS-232C, 91-92 
receiver for RS-232C, 94-96 

standard, 86 
Interrupt, 20-21, 35 

modes, 20-21 

modifications, 39-40 
I/o chip, EPROM, 8755, 105-106 



Keyboard input, 25-26, 34 



Memory— cont 
map, TRS-80, 15 
programmable read-only, 97 
read 

-only, expansion, 42-43 
/write, expansion, 43-47 
Microprocessor, 15 
Model 

I, Modification of, 36-47 
III, Modification of, 47-51 
Modes, interrupt, 20-21 
Modification of 
Model 
I, 36-47 
III, 47-51 
TRS-80, 35-51 
Monitor, FROLIC, 53 
Move command, 72 

N 

N command, 70-71 



O command, 71-72 

Output 

command, 71-72 
video, 24-25, 33-34 



L command, 75 

Light, ultraviolet, 99 

List command, 75 

Logic, memory decode, 40-42 

Loop, current, 88-89 

M 

M command, 72 
Machine code, 11 
Mark, 86, 89 
Memory 

decode logic, 40-42 

erasable programmable read-only, 

97,98 
expansion, read- 
only, 42-43 
write, 42-43 



P command, 75-76, 114-115 

Physics, EPROM, 98-99 

Plug, 25-pin, 88 

Port assignments, 23, 31-33 

PPI chip, 106 

Program locations for the 2708 
EPROM, 115-116 

Programmable 
EPROMs, 99-100 
peripheral interface, 106 
read-only memory, 97 

Programmer, EPROM 
hardware, 106-111 
using, 113 

Programming 

command, 114-115 
considerations, 100-105 
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Programming— cont 
8755 EPROM, 117-119 
2708 EPROM, 111-116 
2716 EPROM, 116-117 

PROM, 97 



Q command, 69 
Quest command, 69 



R command, 73-74 
Rate 

baud, 94 

data, 90 
Read 

command, 73-74, 113-114 

-only memory expansion, 42-43 

/write memory expansion, 43-47 
Receiver, serial interface, 

for RS-232C, 94-96 
Recorders, cassette, 96 
ROMs, erasable programmable, 98-100 
RS-232C, 86-88 

driver code for, 91-92 

serial interface receiver for, 94-96 



T-BUG, 13 

T command, 67-68 

Tape 

data format, 27-30 

input/output, 26-27, 35 
Transfer command, 67-68 
TRS-80, 11, 14-18 

Model 
I, 18-30 
III, 30-35 

modification of, 35-51 
Turnkey system, 13 
20-mA current loop, 89 
2708 EPROM 

program locations for, 115-116 

programming, 111-116 
2716 EPROM, 99 

programming, 116-117 
2732 EPROM, 100 
2758 EPROM, 100 
2780 EPROM, 99 



U 



U command, 76-77 
Ultraviolet light, 99 
User command, 76-77 



S command, 57-58 

Serial 

input, 92-94 
interface 

driver code for RS-232C, 91-92 
receiver for RS-232C, 94-96 

Short-cycle program command, 115 

Shunts, DIP, 40-41, 42-43, 43-47 

Signals, control, 22-23 

Single- 
step command, 81-84 
voltage EPROMs, 105 

Space, 86, 89 

Stackpointer, 63 

String, buffer, 77 

Substitute command, 57-58 

System control, 20 



V command, 72-73 
Verification, 73 

command, 114 
Video output, 24-25, 33-34 

W 

W command, 73 
Write command, 73 



X command, 63-65 
(modify), 65-66 



Z command, 81-84 
Z-80, 17 
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READER SERV£<::e CAM.O 

To better serve you, the reader, please take a moment to fill out 
this card, or a copy of it, for us. Not only will you be kept up to date 
on the Blacksburg Series books, but as an extra bonus, we will 
randomly select five cards every month, from all of the cards sent to 
us during the previous month. The names that are drawn will win, 
absolutely free, a book from the Blacksburg Continuing Education 
Series. Therefore, make sure to indicate your choice in the space 
provided below. For a complete listing of all the books to choose 
from, refer to the inside front cover of this book. Please, one card 
per person. Give everyone a chance. 

In order to fmd out who has won a book in your area, call (703) 
953-1861 anytime during the night or weekend. When you do call, 
an answering machine will let you know the monthly winners. Too 
good to be true? Just give us a call. Good luck. 

If I win, please send me a copy of: 



I understand that this book will be sent to me absolutely free, if my 
card is selected. 



For our information, how about telling us a little about 
yourself. We are interested in your occupation, how and where you 
normally purchase books and the books that you would like to see 
in the Blacksburg Series. We are also interested in finding authors 
for the series, so if you have a book idea, write to The Blacksburg 
Group, Inc., P.O. Box 242, Blacksburg, VA 24060 and ask for an 
Author Packet. We are also interested in TRS-80, APPLE, OSI 
and PET BASIC programs. 

My occupation is 

I buy books through/ from 

Would you buy books through the mail? 

I'd Uke to see a book about 

Name 

Address 

City 

State 



Zip . 



MAIL TO: BOOKS, BOX 715, BLACKSBURG, VA 24060 
!!!!!PLEASE PRINT!!!!! 



The Blacksburg Group 



Accordfng to Busineu Wsek magazine (Technalogy July 6, 1976) larga seal* mtegratvd cfrculti 
or LSI "chipi^' are creating a tecond induitrial revolution thaf will quickly involve ui all. The 
speed of the developments Jn thi» area is breathtaking and it becomes mor« ond more difficult to 
keep up with the rapid advances that ore being made. It 'a also becoming dilficult for newcomert 
to "get on board/' 

It has been aur objective, as The Blocksburg Croup^ to develop timely ond effective educational 
materials that will permif studenti, engineers, scientists, technicians and others to quickly learn 
how to uie new technologiei and electronic techniques. We continue to do this through several 
m«oris, textbooks, short courses, seminar* and through the development of tpecJol electronic de* 
vtcM and training aids. 

Our group members moke their home in Biacksburg, found in the Appalachian Mountolni of 

southwestern Virgmia. While we didn't actively itart our group collQborotion until the Spring 

of 1974, members of our group hove been involved fn digital eleclronict, minicomputer! and 
microcomputers for some time. 

Some of our past expenences and on-going efforts include the folUywIng: 

-The design and development of what is coniidered to be the first popular hobbyist computer. 
The Mark-B was featured in Radio-Electronics magazine in 1974. We have also designed several 
BOSO-bosed computers, including the MMD-1 system. Our most recent conipufer il on B0B5-based 
computer for educational use, and for uifi in small controllers. 



through microcomputers, operational amplifiers, and active filters. Test experiments and examples 
have been provided in each book. We are strong believers in the use of detailed experiments and 
•xamplet to reinforce basic concepts. This series originally started as our Bugboob series and many 
tittet ore now being translated into Chinese^ Japanese, German and Italian. 

—We have pioneered the use of small, self-contained computers in hands-on courses for micro- 
computer users. Many of our designs hove evolved into commercial products that are morketed 
by E&L Instruments and PACCOM, and are available from Group Technology, Ltd., Check, VA 
24072. 

-Our short courses and seminar programs have been presented throughout the world. Programs 
ore offered by The Blacksburg Group, and by the Virginia Polytechnic Institute Extension Divi^- 
lion. Each series of courses provides hands-on experience with real computers and electronic 
devices. Courses ar^d seminar* ore provided on a regular bosis^ and are also provided for groups, 
companies and schools at o site of their choosing. We ore strong believer* in practical labora- 
tory exercises, lo much time is spent working with electronic equipment, computers and circuits. 

Additionol information may be obtained from Dr. Chris Titus, the Blacksburg Group, Inc. (703) 
931-9(I30 or from Or. Undo Leffet, Virginia Tech Continuing Education Center (703) 961-5241. 

Our group member* ore Mr. David G. Lorsen, who is on the faculty of the Deportment of Chem- 
istry at Virginia Tech, and Drs. Jon T^tus and Chris Titus who work full-time with The Blacksburg 
Group, all of Blacksburg,^ VA. 



TRS-80 
MORE THAN BASIC 

This book presents a monitor program that mal<es a 
TRS-80 Model I or III microcomputer into a develop- 
ment system. 

• The TRS-80 can be converted by loading object code 
from cassette or diskette, or by ROM replacement. 

' Ttie monitor executes valid instructions or commands, 
and it flags errors. 

Ttie development system can be used to program in 
Z-80 mnemonics. 

Over 26 commands are available; the user is given 
total documentation. 

The book also 

• Describes hardware for a single-stepping feature. 

• Discusses hardware for programming most of the 
popular EPROf^s. 

• Provides source codes for the monitor and the 
EPROM progrommer. 

• Presents hardware and software features of the TRS-80 
Models I and III. 



HoujQrd UU. Soms & Co.. Inc. 

4300 W 63nrt Straet. Indianapolis, indiono 4626S USA 
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